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

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '<YOUR HOST>/v1/broadcasts' \
  --header 'x-api-key: text'

200

200

[
  {
    "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 response

post

Authorizations

Header parameters

x-api-keystringrequired

Body

idstringoptional

namestringrequired

typestring · enumrequired

Options: client, contact, class, retarget

statusstringoptional

segmentsobject[]optional

targetClassobjectoptional

targetClassStatusstring · enumoptional

Options: ALL, WAITLISTED, BOOKED, VISITED, RESCHEDULED, NO_SHOW, CANCELLED

retargetBroadcastobjectoptional

retargetEngagementTypestring · enumoptional

Options: sent, delivered, read, replied, not-replied

scheduleDateTimestringoptional

startedAtstringoptional

completedAtstringoptional

templateobjectoptional

headerMediaUrlstringoptional

headerTextParametersstring[]optional

bodyTextParametersstring[]optional

buttonUrlParametersstring[]optional

locationParametersobjectoptional

flowParametersobjectoptional

locationobjectrequired

processedStatsobjectoptional

deliveryStatsobjectoptional

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '<YOUR HOST>/v1/broadcasts' \
  --header 'x-api-key: text' \
  --header 'Content-Type: application/json' \
  --data '{
    "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

{
  "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 response

get

Authorizations

Path parameters

broadcastIdstringrequired

Header parameters

x-api-keystringrequired

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '<YOUR HOST>/v1/broadcasts/{broadcastId}' \
  --header 'x-api-key: text'

200

200

{
  "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 response

put

Authorizations

Path parameters

broadcastIdstringrequired

Header parameters

x-api-keystringrequired

Body

idstringoptional

namestringrequired

typestring · enumrequired

Options: client, contact, class, retarget

statusstringoptional

segmentsobject[]optional

targetClassobjectoptional

targetClassStatusstring · enumoptional

Options: ALL, WAITLISTED, BOOKED, VISITED, RESCHEDULED, NO_SHOW, CANCELLED

retargetBroadcastobjectoptional

retargetEngagementTypestring · enumoptional

Options: sent, delivered, read, replied, not-replied

scheduleDateTimestringoptional

startedAtstringoptional

completedAtstringoptional

templateobjectoptional

headerMediaUrlstringoptional

headerTextParametersstring[]optional

bodyTextParametersstring[]optional

buttonUrlParametersstring[]optional

locationParametersobjectoptional

flowParametersobjectoptional

locationobjectrequired

processedStatsobjectoptional

deliveryStatsobjectoptional

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url '<YOUR HOST>/v1/broadcasts/{broadcastId}' \
  --header 'x-api-key: text' \
  --header 'Content-Type: application/json' \
  --data '{
    "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

{
  "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 response

delete

Authorizations

Path parameters

broadcastIdstringrequired

Header parameters

x-api-keystringrequired

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request DELETE \
  --url '<YOUR HOST>/v1/broadcasts/{broadcastId}' \
  --header 'x-api-key: text'

200

200

{
  "success": true
}

200 response

get

Authorizations

Path parameters

broadcastIdstringrequired

Query parameters

limitstringoptional

pagestringoptional

Header parameters

x-api-keystringrequired

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '<YOUR HOST>/v1/broadcasts/{broadcastId}/logs' \
  --header 'x-api-key: text'

200

200

[
  {
    "broadcast": {
      "id": "text",
      "name": "text"
    },
    "recepientName": "text",
    "countryCode": "text",
    "phone": "text",
    "status": "read",
    "reply": "text",
    "error": "text",
    "createdAt": "2025-03-31T09:31:28.904Z",
    "updatedAt": "2025-03-31T09:31:28.904Z"
  }
]

200 response