Skip to main content
POST
/
threads
/
{threadId}
/
messages
Send message
curl --request POST \
  --url https://inboxapp.com/api/v1/threads/{threadId}/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "content": "<string>"
}
'
{
  "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>"
  ]
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
threadId
string
required

Body

application/json
​
content
string
required
Minimum string length: 1

Response

200 - application/json

OK

​
platform
enum<string>
required

The platform the message was sent from.

Available options:
twitter,
sandbox
Example:

"twitter"

​
teamId
string
required
Example:

"df6jbw4h36..."

​
threadId
string
required
Example:

"df6jbw4h36..."

​
id
string
required

The Inbox ID of the message.

Example:

"df6jbw4h36..."

​
userId
string | null
required

The Inbox user who sent this message if applicable.

Example:

"df6jbw4h36..."

​
createdAt
string<date-time>
required
​
updatedAt
string<date-time> | null
required
​
platformId
string | null
required
Example:

"1234567890"

​
content
string
required
Example:

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

​
campaignId
string | null
required

The Inbox campaign ID that sent this message if applicable.

Example:

"df6jbw4h36..."

​
authorId
string
required

Will either be the accountLinkId or the externalId of the thread.

Example:

"df6jbw4h36..."

​
origin
enum<string> | null
required

The origin of the message. 'internal' means send from a user on Inbox, 'external' means synced from Twitter, 'api' means sent via the API.

Available options:
internal,
external,
api
Example:

"internal"

​
replyData
any | null
required

The reply data of the message if applicable.

​
entities
any | null
required

The entities of the message if applicable.

​
attachment
any | null
required

The attachment of the message if applicable.

​
reactions
any[] | null
required

The reactions of the message if applicable.