Skip to main content
POST
/
threads
/
messages
Quick send message
curl --request POST \
  --url https://inboxapp.com/api/v1/threads/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "accountLinkId": "<string>",
  "content": "<string>",
  "externalPlatformId": "<string>",
  "externalId": "<string>"
}
'
{
  "message": {
    "platform": "twitter",
    "teamId": "<string>",
    "threadId": "<string>",
    "id": "<string>",
    "userId": "df6jbw4h36...",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "platformId": "1234567890",
    "content": "<string>",
    "campaignId": "df6jbw4h36...",
    "authorId": "<string>",
    "origin": "internal",
    "replyData": "<unknown>",
    "entities": "<unknown>",
    "attachment": "<unknown>",
    "reactions": [
      "<unknown>"
    ]
  },
  "thread": {
    "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

The account link ID to send the message from.

Example:

"df6jbw4h36..."

content
string
required
Minimum string length: 1
Example:

"Hey, I'm reaching out from Acme Agency..."

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.

Example:

"1234567890"

Response

200 - application/json

OK

message
object
required
thread
object
required