Skip to main content
POST
/
threads
Create thread
curl --request POST \
  --url https://inboxapp.com/api/v1/threads \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "accountLinkId": "<string>",
  "externalPlatformId": "<string>",
  "externalId": "<string>"
}
'
{
  "id": "<string>",
  "done": true,
  "assigneeId": "df6jbw4h36...",
  "lastMessageTimestamp": "2025-08-22T12:00:00.000Z",
  "computedSortTimestamp": "2025-08-22T12:00:00.000Z",
  "createdAt": "2023-11-07T05:31:56Z",
  "status": "active",
  "accountLinkId": "<string>",
  "isSyncing": true,
  "isRequest": true,
  "lastMessage": {
    "id": "<string>",
    "content": "<string>",
    "authorId": "<string>",
    "createdAt": "2023-11-07T05:31:56Z",
    "userId": "df6jbw4h36...",
    "campaignId": "df6jbw4h36..."
  },
  "prospect": {
    "platform": "twitter",
    "platformId": "<string>",
    "externalId": "l44e15irdq4db30i77cgphhx",
    "documentId": 858224163,
    "displayName": "<string>",
    "username": "<string>",
    "handle": "<string>",
    "image": "https://pbs.twimg.com/profile_images/1954360649393295360/rwp-vVt6.jpg",
    "imageNormalized": "https://pbs.twimg.com/profile_images/1954360649393295360/rwp-vVt6.jpg",
    "bio": "Social Selling CRM Close deals faster, stay organized, and never miss an opportunity. Starting with X",
    "location": "San Francisco, CA",
    "profileUrl": "<string>",
    "websiteUrl": "https://inboxapp.com",
    "websiteDomain": "inboxapp.com",
    "verified": "none",
    "profileType": "personal",
    "isProtected": true,
    "followerCount": 123,
    "followingCount": 123,
    "postCount": 123,
    "engagementCount": 2613,
    "listedCount": 18,
    "platformCreatedAt": "2022-09-03T17:58:06.000Z",
    "firstSeenAt": "2024-07-09T14:08:49.000Z",
    "lastUpdatedAt": "2023-11-07T05:31:56Z",
    "lastEnrichedAt": "2025-11-10T18:03:16.000Z",
    "lastActiveAt": "2025-11-10T12:00:00.000Z",
    "source": "cached",
    "isFresh": true,
    "isStale": true,
    "confidence": 0.5,
    "platformData": {
      "isVerifiedBlue": true,
      "isVerifiedGold": true,
      "isVerifiedGray": true,
      "professionalCategory": "986",
      "urlEntities": [
        {
          "url": "<string>",
          "expandedUrl": "<string>",
          "displayUrl": "<string>",
          "indices": [
            123,
            123
          ]
        }
      ],
      "bannerUrl": "https://pbs.twimg.com/profile_banners/1566123362161725440/1753273968",
      "tweetsCount": 123,
      "favoritesCount": 123,
      "rawData": {}
    },
    "context": {
      "tags": [
        "<string>"
      ],
      "statusId": "df6jbw4h36...",
      "valuation": 599,
      "notes": "This prospect is a potential customer."
    }
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
accountLinkId
string
required

The account link ID to associate with this thread. This determines which connected account the thread belongs to.

​
externalPlatformId
string

The platform ID of the prospect. Must be provided if externalId is not provided.

Example:

"1234567890"

​
externalId
string

The Inbox external ID of the prospect. Must be provided if externalPlatformId is not provided.

Response

200 - application/json

OK

​
id
string
required

The ID of the thread.

Example:

"df6jbw4h36..."

​
done
boolean
required

Whether the thread has been archived or not.

Example:

true

​
assigneeId
string | null
required

The ID of the member assigned to the thread.

Example:

"df6jbw4h36..."

​
lastMessageTimestamp
string<date-time> | null
required

The timestamp of the last message in the thread.

Example:

"2025-08-22T12:00:00.000Z"

​
computedSortTimestamp
string<date-time> | null
required

The timestamp of the last message in the thread or the creation date if no messages have been sent.

Example:

"2025-08-22T12:00:00.000Z"

​
createdAt
string<date-time>
required

The timestamp of when the thread was created in Inbox.

Example:

"2025-08-22T12:00:00.000Z"

​
status
enum<string>
required

Idle threads are hidden from the main inbox, i.e. when previewing a profile using 'Quick peek'

Available options:
active,
idle
Example:

"active"

​
accountLinkId
string
required

The ID of the account link associated with this thread.

Example:

"df6jbw4h36..."

​
isSyncing
boolean
required

Whether the thread is currently syncing data from Twitter to load all messages.

Example:

false

​
isRequest
boolean
required

Whether this conversation is a message request.

Example:

false

​
lastMessage
object
required
​
prospect
object
required