WIwithallo
Threads

Create thread

Changed on

Starts a discussion thread on a conversation item with a first comment. Each item can have only one thread.

post/v2/api/threads

Request

  • Base URL
    https://api.withallo.com
  • URL
    https://api.withallo.com/v2/api/threads
  • Auth
    API key in header Authorization

Request body

entity_type'CALL' | 'TEXT_MESSAGE' | 'CONVERSATION_NOTE' required

Type of the conversation item to attach the thread to.

entity_idstring required

ID of the conversation item (cll-*, msg-*, or not-*).

contentstring required

First comment text (max 4000 characters). Mention teammates inline with @[Name](usr-...).

Example request

{
  "entity_id": "cll-abc123",
  "content": "Can someone call them back today? @[Jane Doe](usr-abc123)"
}

Response

Thread created with its first comment

Example response

{
  "data": {
    "id": "cth-abc123",
    "entity_id": "cll-abc123",
    "contact_number": "+14155551234",
    "resolved_by": {
      "id": "usr-def456",
      "name": "John Smith"
    },
    "comments": [
      {
        "id": "thc-abc123",
        "user": {
          "id": "usr-def456",
          "name": "John Smith"
        },
        "mentions": [
          {
            "user_id": "usr-abc123",
            "name": "Jane Doe"
          }
        ]
      }
    ]
  }
}

Changes