Conversations

Pin conversation

Changed on

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 missing or blank allo_number returns 400 INVALID_REQUEST_BODY.

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

Request

  • Base URL
    https://api.withallo.com
  • URL
    https://api.withallo.com/v2/api/conversations/{contact_number}/pin
  • Auth
    API key in header Authorization

Path parameters

contact_numberstring required
Example:+14155551234

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

Request body

allo_numberstring required

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

Example request

{
  "allo_number": "+14155550100"
}

Response

Conversation pinned

Changes