Skip to main content
POST
/
unified
/
messaging
/
messages
Send Message
curl --request POST \
  --url https://api.stackone.com/unified/messaging/messages \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --header 'x-account-id: <x-account-id>' \
  --data '
{
  "content": "Hello, world!",
  "recipient": "c28xyrc55866bvuv",
  "sender": "+34820398402"
}
'
{
  "statusCode": 201,
  "message": "Record created successfully.",
  "timestamp": "2021-01-01T01:01:01.000Z",
  "data": {
    "id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3",
    "remote_id": "8187e5da-dc77-475e-9949-af0f1fa4e4e3"
  }
}

Authorizations

​
Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Headers

​
x-account-id
string
required

The account identifier

Body

application/json
​
content
string | null

Content body of the message

Example:

"Hello, world!"

​
recipient
string | null

Can be a conversation ID, user ID, email or phone number.

Example:

"c28xyrc55866bvuv"

​
sender
string | null

The account_id or phone number of the message sender

Example:

"+34820398402"

Response

The message was sent successfully.

​
statusCode
number
required
Example:

201

​
message
string
required
Example:

"Record created successfully."

​
timestamp
string<date-time>
required
Example:

"2021-01-01T01:01:01.000Z"

​
data
object
required