Allo

Pin conversation

Pins a conversation for the caller. Up to 10 conversations can be pinned. Pinning a conversation that is already pinned returns 204 and changes nothing. A…

PUT/v2/api/conversations/{contact_number}/pin

Behavior

Pins the conversation with contact_number on the Allo line allo_number, for the caller only. Returns 204 with no body, also when the conversation is already pinned.

Each user can pin up to 10 conversations. Filter pinned conversations with pinned=true on List conversations.

Errors

StatusCodeWhen
400INVALID_REQUEST_BODYallo_number is missing or blank
403ALLO_NUMBER_FORBIDDENThe caller cannot access this line
409PIN_LIMIT_REACHEDThe caller already has 10 pinned conversations. Unpin one first

Authorization

Authorizationstring · headerrequired

Api-Key ak_live_…

Path parameters

contact_numberstringrequired

The external phone number in E.164 format. URL-encode the + as %2B.

Body

allo_numberstringrequired

Allo line the conversation is on (E.164).

Responses

204Conversation pinned
400
401
403
409
429