Skip to main content
POST
/
v2
/
telematics
/
messages
Create Message
curl --request POST \
  --url https://api.catenatelematics.com/v2/telematics/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "connection_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Documentation Index

Fetch the complete documentation index at: https://docs.catenatelematics.com/llms.txt

Use this file to discover all available pages before exploring further.

Provisional endpoint
This endpoint is available for early access. The core schema is stable, but minor details — such as field names or added fields — may change before it becomes generally available. Backward compatibility is not guaranteed.

See API Stability & Versioning for details on provisional endpoints.

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json

Message model for creating new records

​
connection_id
string<uuid>
required

Unique identifier of the connection at Catena Telematics which will be used to create this resource. A connection represents a Fleet/TSP pairing.

​
fleet_ref
string | null

External fleet reference in the partner system.

​
source_sender_id
string | null

External system identifier for the sender

​
source_recipient_ids
string[] | null

External system identifiers for the recipients

​
recipient_group
enum<string> | null

Recipient group for the message

Available options:
admin,
driver,
dispatcher
​
sender_group
enum<string> | null

Sender group for the message

Available options:
admin,
driver,
dispatcher
​
message_text
string | null

The content of the message

​
mode
enum<string> | null

Whether the message is a group message, bulk message, or direct message

Available options:
group,
bulk,
direct
​
priority
enum<string> | null

Optional priority for the message: low, medium, or high

Available options:
low,
medium,
high
​
source_thread_id
string | null

Thread/conversation identifier. Represents a shared conversation across multiple messages.

​
source_reply_to_message_id
string | null

Message reference, for which this message is a reply to

Response

The request to create the message has been accepted and is being processed.

Resource operation model for API responses

​
id
string<uuid>
required

Unique identifier for the resource operation.