Discover our collection of useful tips and tricks that will help you use the IXM Aqua API even more efficiently.
Restrict to specific client
Use the header x-clientId: <ClientId> to restrict your request to only the client whose client ID you specify.
Use your own ID
When you create a new entity, such as a broadcast, we recommend that you always provide your own ID to keep track of the entity you created.
Example:
The following example shows how to create a Share of Voice broadcast with my-own-id as ID.
POST https://connect.eu01.grassfish.com/api/broadcasts
Authorization: Bearer xxx
Content-Type: application/json
[
{
"id": "my-own-id",
"name": "my-new-broadcast",
"type": "SoV",
"startDate": "2025-06-02T00:00:00.000Z",
"endDate": "2025-06-04T00:00:00.000Z",
"groups": [
{
"name": "Group 1",
"media": [
],
"spotLengthSecs": 30,
"tags": [
{
"Id": "my-previous-created-sov-content-type-id",
"type": "ContentType"
}
]
}
],
"schedules": [
]
}
]