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."
}
}
}
}Send a message without knowing the thread ID ahead of time. Automatically creates a thread if needed.
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."
}
}
}
}Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
The account link ID to send the message from.
"df6jbw4h36..."
1"Hey, I'm reaching out from Acme Agency..."
The platform ID of the prospect. Must be provided if externalId is not provided.
"1234567890"
The Inbox external ID of the prospect. Must be provided if externalPlatformId is not provided.
"1234567890"
Was this page helpful?