Skip to main content
POST
/
accounts
/
{id}
/
dms
/
{tid}
/
send
Send a direct message
curl --request POST \
  --url https://api.social-api.ai/v1/accounts/{id}/dms/{tid}/send \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "text": "Hi! How can we help you today?"
}
'
{
  "created_at": "2026-02-15T14:35:00Z",
  "id": "socapi_cmt_cmVwbHk6MTIzNDU2Nzg5"
}

Authorizations

​
Authorization
string
header
required

Prefix your API key with "Bearer ". Example: Authorization: Bearer soc_live_...

Path Parameters

​
id
string
required

Connected account ID

​
tid
string
required

DM thread ID

Body

application/json

Message payload

​
text
string

Text is the message content. Required.

Example:

"Hi! How can we help you today?"

Response

The sent message

​
created_at
string
Example:

"2026-02-15T14:35:00Z"

​
id
string
Example:

"socapi_cmt_cmVwbHk6MTIzNDU2Nzg5"