> ## 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.

# v2.69.0 - Flexible Sender ID for Group Messages

> sender_id is now optional and accepts multiple identifier types when creating 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.

<Check>
  **Backward-compatible change:** Existing requests that supply a UUID string for `sender_id` continue to work without modification.
</Check>

## 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:

```bash theme={null}
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):

```bash theme={null}
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"
}
```

***

## Need help?

<CardGroup cols={2}>
  <Card title="API reference" icon="book" href="/api-reference/telematics-api">
    View complete endpoint documentation for the Telematics API
  </Card>

  <Card title="Contact support" icon="life-ring" href="mailto:support@catenaclearing.io">
    Questions about your integration? Our team is here to help
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.