Broadcasts

The Broadcasts CRUD API empowers users to manage messaging broadcasts seamlessly, offering Create, Read, Update, and Delete operations.

This API feature set enables scheduling broadcasts on WhatsApp. Please make sure the scheduleDateTime parameter adheres to UTC for precise timing.

get

Authorizations

Query parameters

limitstringOptional

endDatestringOptional

locationIdstringOptional

pagestringOptional

startDatestringOptional

searchTextstringOptional

Header parameters

x-api-keystringRequired

Responses

200

200 response

application/json

get

HTTPcURLJavaScriptPython

GET /v1/broadcasts HTTP/1.1
Host: <YOUR HOST>
x-api-key: text
Accept: */*

200

200 response

[
  {
    "id": "text",
    "name": "text",
    "type": "client",
    "status": "text",
    "segments": [
      {
        "id": "text"
      }
    ],
    "targetClass": {
      "id": "text"
    },
    "targetClassStatus": "ALL",
    "retargetBroadcast": {
      "id": "text"
    },
    "retargetEngagementType": "sent",
    "scheduleDateTime": "text",
    "startedAt": "text",
    "completedAt": "text",
    "template": {
      "name": "text",
      "language": "text"
    },
    "headerMediaUrl": "text",
    "headerTextParameters": [
      "text"
    ],
    "bodyTextParameters": [
      "text"
    ],
    "buttonUrlParameters": [
      "text"
    ],
    "locationParameters": {
      "latitude": 1,
      "longitude": 1,
      "address": "text",
      "name": "text"
    },
    "flowParameters": {
      "flowToken": "text",
      "flowData": "text"
    },
    "location": {
      "id": "text"
    },
    "processedStats": {
      "totalCount": 1,
      "successCount": 1,
      "failureCount": 1
    },
    "deliveryStats": {
      "sentCount": 1,
      "deliveredCount": 1,
      "readCount": 1,
      "failedCount": 1,
      "repliedCount": 1
    }
  }
]

post

Authorizations

Header parameters

x-api-keystringRequired

Body

idstringOptional

namestringRequired

typestring · enumRequiredPossible values:

statusstringOptional

targetClassStatusstring · enumOptionalPossible values:

retargetEngagementTypestring · enumOptionalPossible values:

scheduleDateTimestringOptional

startedAtstringOptional

completedAtstringOptional

headerMediaUrlstringOptional

headerTextParametersstring[]Optional

bodyTextParametersstring[]Optional

buttonUrlParametersstring[]Optional

Responses

200

200 response

application/json

post

HTTPcURLJavaScriptPython

POST /v1/broadcasts HTTP/1.1
Host: <YOUR HOST>
x-api-key: text
Content-Type: application/json
Accept: */*
Content-Length: 762

{
  "id": "text",
  "name": "text",
  "type": "client",
  "status": "text",
  "segments": [
    {
      "id": "text"
    }
  ],
  "targetClass": {
    "id": "text"
  },
  "targetClassStatus": "ALL",
  "retargetBroadcast": {
    "id": "text"
  },
  "retargetEngagementType": "sent",
  "scheduleDateTime": "text",
  "startedAt": "text",
  "completedAt": "text",
  "template": {
    "name": "text",
    "language": "text"
  },
  "headerMediaUrl": "text",
  "headerTextParameters": [
    "text"
  ],
  "bodyTextParameters": [
    "text"
  ],
  "buttonUrlParameters": [
    "text"
  ],
  "locationParameters": {
    "latitude": 1,
    "longitude": 1,
    "address": "text",
    "name": "text"
  },
  "flowParameters": {
    "flowToken": "text",
    "flowData": "text"
  },
  "location": {
    "id": "text"
  },
  "processedStats": {
    "totalCount": 1,
    "successCount": 1,
    "failureCount": 1
  },
  "deliveryStats": {
    "sentCount": 1,
    "deliveredCount": 1,
    "readCount": 1,
    "failedCount": 1,
    "repliedCount": 1
  }
}

200

200 response

{
  "id": "text",
  "name": "text",
  "type": "client",
  "status": "text",
  "segments": [
    {
      "id": "text"
    }
  ],
  "targetClass": {
    "id": "text"
  },
  "targetClassStatus": "ALL",
  "retargetBroadcast": {
    "id": "text"
  },
  "retargetEngagementType": "sent",
  "scheduleDateTime": "text",
  "startedAt": "text",
  "completedAt": "text",
  "template": {
    "name": "text",
    "language": "text"
  },
  "headerMediaUrl": "text",
  "headerTextParameters": [
    "text"
  ],
  "bodyTextParameters": [
    "text"
  ],
  "buttonUrlParameters": [
    "text"
  ],
  "locationParameters": {
    "latitude": 1,
    "longitude": 1,
    "address": "text",
    "name": "text"
  },
  "flowParameters": {
    "flowToken": "text",
    "flowData": "text"
  },
  "location": {
    "id": "text"
  },
  "processedStats": {
    "totalCount": 1,
    "successCount": 1,
    "failureCount": 1
  },
  "deliveryStats": {
    "sentCount": 1,
    "deliveredCount": 1,
    "readCount": 1,
    "failedCount": 1,
    "repliedCount": 1
  }
}

get

Authorizations

Path parameters

broadcastIdstringRequired

Header parameters

x-api-keystringRequired

Responses

200

200 response

application/json

get

HTTPcURLJavaScriptPython

GET /v1/broadcasts/{broadcastId} HTTP/1.1
Host: <YOUR HOST>
x-api-key: text
Accept: */*

200

200 response

{
  "id": "text",
  "name": "text",
  "type": "client",
  "status": "text",
  "segments": [
    {
      "id": "text"
    }
  ],
  "targetClass": {
    "id": "text"
  },
  "targetClassStatus": "ALL",
  "retargetBroadcast": {
    "id": "text"
  },
  "retargetEngagementType": "sent",
  "scheduleDateTime": "text",
  "startedAt": "text",
  "completedAt": "text",
  "template": {
    "name": "text",
    "language": "text"
  },
  "headerMediaUrl": "text",
  "headerTextParameters": [
    "text"
  ],
  "bodyTextParameters": [
    "text"
  ],
  "buttonUrlParameters": [
    "text"
  ],
  "locationParameters": {
    "latitude": 1,
    "longitude": 1,
    "address": "text",
    "name": "text"
  },
  "flowParameters": {
    "flowToken": "text",
    "flowData": "text"
  },
  "location": {
    "id": "text"
  },
  "processedStats": {
    "totalCount": 1,
    "successCount": 1,
    "failureCount": 1
  },
  "deliveryStats": {
    "sentCount": 1,
    "deliveredCount": 1,
    "readCount": 1,
    "failedCount": 1,
    "repliedCount": 1
  }
}

put

Authorizations

Path parameters

broadcastIdstringRequired

Header parameters

x-api-keystringRequired

Body

idstringOptional

namestringRequired

typestring · enumRequiredPossible values:

statusstringOptional

targetClassStatusstring · enumOptionalPossible values:

retargetEngagementTypestring · enumOptionalPossible values:

scheduleDateTimestringOptional

startedAtstringOptional

completedAtstringOptional

headerMediaUrlstringOptional

headerTextParametersstring[]Optional

bodyTextParametersstring[]Optional

buttonUrlParametersstring[]Optional

Responses

200

200 response

application/json

put

HTTPcURLJavaScriptPython

PUT /v1/broadcasts/{broadcastId} HTTP/1.1
Host: <YOUR HOST>
x-api-key: text
Content-Type: application/json
Accept: */*
Content-Length: 762

{
  "id": "text",
  "name": "text",
  "type": "client",
  "status": "text",
  "segments": [
    {
      "id": "text"
    }
  ],
  "targetClass": {
    "id": "text"
  },
  "targetClassStatus": "ALL",
  "retargetBroadcast": {
    "id": "text"
  },
  "retargetEngagementType": "sent",
  "scheduleDateTime": "text",
  "startedAt": "text",
  "completedAt": "text",
  "template": {
    "name": "text",
    "language": "text"
  },
  "headerMediaUrl": "text",
  "headerTextParameters": [
    "text"
  ],
  "bodyTextParameters": [
    "text"
  ],
  "buttonUrlParameters": [
    "text"
  ],
  "locationParameters": {
    "latitude": 1,
    "longitude": 1,
    "address": "text",
    "name": "text"
  },
  "flowParameters": {
    "flowToken": "text",
    "flowData": "text"
  },
  "location": {
    "id": "text"
  },
  "processedStats": {
    "totalCount": 1,
    "successCount": 1,
    "failureCount": 1
  },
  "deliveryStats": {
    "sentCount": 1,
    "deliveredCount": 1,
    "readCount": 1,
    "failedCount": 1,
    "repliedCount": 1
  }
}

200

200 response

{
  "id": "text",
  "name": "text",
  "type": "client",
  "status": "text",
  "segments": [
    {
      "id": "text"
    }
  ],
  "targetClass": {
    "id": "text"
  },
  "targetClassStatus": "ALL",
  "retargetBroadcast": {
    "id": "text"
  },
  "retargetEngagementType": "sent",
  "scheduleDateTime": "text",
  "startedAt": "text",
  "completedAt": "text",
  "template": {
    "name": "text",
    "language": "text"
  },
  "headerMediaUrl": "text",
  "headerTextParameters": [
    "text"
  ],
  "bodyTextParameters": [
    "text"
  ],
  "buttonUrlParameters": [
    "text"
  ],
  "locationParameters": {
    "latitude": 1,
    "longitude": 1,
    "address": "text",
    "name": "text"
  },
  "flowParameters": {
    "flowToken": "text",
    "flowData": "text"
  },
  "location": {
    "id": "text"
  },
  "processedStats": {
    "totalCount": 1,
    "successCount": 1,
    "failureCount": 1
  },
  "deliveryStats": {
    "sentCount": 1,
    "deliveredCount": 1,
    "readCount": 1,
    "failedCount": 1,
    "repliedCount": 1
  }
}

delete

Authorizations

Path parameters

broadcastIdstringRequired

Header parameters

x-api-keystringRequired

Responses

200

200 response

application/json

delete

HTTPcURLJavaScriptPython

DELETE /v1/broadcasts/{broadcastId} HTTP/1.1
Host: <YOUR HOST>
x-api-key: text
Accept: */*

200

200 response

{
  "success": true
}

get

Authorizations

Path parameters

broadcastIdstringRequired

Query parameters

limitstringOptional

pagestringOptional

Header parameters

x-api-keystringRequired

Responses

200

200 response

application/json

get

HTTPcURLJavaScriptPython

GET /v1/broadcasts/{broadcastId}/logs HTTP/1.1
Host: <YOUR HOST>
x-api-key: text
Accept: */*

200

200 response

[
  {
    "broadcast": {
      "id": "text",
      "name": "text"
    },
    "recepientName": "text",
    "countryCode": "text",
    "phone": "text",
    "status": "read",
    "reply": "text",
    "error": "text",
    "createdAt": "2025-06-01T07:52:59.707Z",
    "updatedAt": "2025-06-01T07:52:59.707Z"
  }
]