v2.69.0 - Flexible Sender ID for Group Messages

Released 14th September 2026 This release relaxes the sender_id field on POST /v2/telematics/group-messages. The field is no longer required and now accepts multiple identifier types via anyOf, giving you more flexibility when creating group messages from systems that do not always have a Catena UUID for the sender.

Backward-compatible change: Existing requests that supply a UUID string for sender_id continue to work without modification.

Group message sender ID

What changed

The sender_id field in the POST /v2/telematics/group-messages request body has been updated:

Property	Before	After
Required	Yes	No
Type	`string<uuid>`	`anyOf` (multiple types)

Previously, sender_id was a required UUID string. It is now optional and accepts multiple identifier formats, allowing you to create group messages without a Catena-assigned sender UUID.

Affected endpoint

POST /v2/telematics/group-messages

Example usage

Create a group message without specifying a sender:

POST /v2/telematics/group-messages
Content-Type: application/json
Authorization: Bearer YOUR_ACCESS_TOKEN

{
  "connection_id": "123e4567-e89b-12d3-a456-426614174000",
  "recipient_ids": ["550e8400-e29b-41d4-a716-446655440000"],
  "message_text": "Pickup confirmed for 14:00"
}

Create a group message with a sender UUID (existing behavior, still supported):

POST /v2/telematics/group-messages
Content-Type: application/json
Authorization: Bearer YOUR_ACCESS_TOKEN

{
  "connection_id": "123e4567-e89b-12d3-a456-426614174000",
  "sender_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "recipient_ids": ["550e8400-e29b-41d4-a716-446655440000"],
  "message_text": "Pickup confirmed for 14:00"
}

Overview

Authentication

Telematics

Organizations

Integrations

Notifications

Intelligence

v2.69.0 - Flexible Sender ID for Group Messages

Group message sender ID

What changed

Affected endpoint

Example usage

Need help?

API reference

Contact support

​Group message sender ID

​What changed

​Affected endpoint

​Example usage

​Need help?

API reference

Contact support

Group message sender ID

What changed

Affected endpoint

Example usage

Need help?