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<YOUR HOST>/v1/broadcasts

Authorization

api_key

Query parameters

Header parameters

Response

200

200 response

Body

application/json

idstring

name*string

type*enum

clientcontactclassretarget

statusstring

segmentsarray of object

targetClassobject

targetClassStatusenum

ALLWAITLISTEDBOOKEDVISITEDRESCHEDULEDNO_SHOWCANCELLED

retargetBroadcastobject

retargetEngagementTypeenum

sentdeliveredreadrepliednot-replied

scheduleDateTimestring

startedAtstring

completedAtstring

templateobject

headerMediaUrlstring

headerTextParametersarray of string

bodyTextParametersarray of string

buttonUrlParametersarray of string

locationParametersobject

flowParametersobject

location*object

processedStatsobject

deliveryStatsobject

Request

JavaScriptCurlPython

const response = await fetch('<YOUR HOST>/v1/broadcasts', {
    method: 'GET',
    headers: {
      "x-api-key": "text"
    },
});
const data = await response.json();

Response

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": 0,
      "longitude": 0,
      "address": "text",
      "name": "text"
    },
    "flowParameters": {
      "flowToken": "text",
      "flowData": "text"
    },
    "location": {
      "id": "text"
    },
    "processedStats": {
      "totalCount": 0,
      "successCount": 0,
      "failureCount": 0
    },
    "deliveryStats": {
      "sentCount": 0,
      "deliveredCount": 0,
      "readCount": 0,
      "failedCount": 0,
      "repliedCount": 0
    }
  }
]

POST<YOUR HOST>/v1/broadcasts

Authorization

api_key

Header parameters

Body

application/json

idstring

name*string

type*enum

clientcontactclassretarget

statusstring

segmentsarray of object

targetClassobject

targetClassStatusenum

ALLWAITLISTEDBOOKEDVISITEDRESCHEDULEDNO_SHOWCANCELLED

retargetBroadcastobject

retargetEngagementTypeenum

sentdeliveredreadrepliednot-replied

scheduleDateTimestring

startedAtstring

completedAtstring

templateobject

headerMediaUrlstring

headerTextParametersarray of string

bodyTextParametersarray of string

buttonUrlParametersarray of string

locationParametersobject

flowParametersobject

location*object

processedStatsobject

deliveryStatsobject

Response

200

200 response

Body

application/json

idstring

name*string

type*enum

clientcontactclassretarget

statusstring

segmentsarray of object

targetClassobject

targetClassStatusenum

ALLWAITLISTEDBOOKEDVISITEDRESCHEDULEDNO_SHOWCANCELLED

retargetBroadcastobject

retargetEngagementTypeenum

sentdeliveredreadrepliednot-replied

scheduleDateTimestring

startedAtstring

completedAtstring

templateobject

headerMediaUrlstring

headerTextParametersarray of string

bodyTextParametersarray of string

buttonUrlParametersarray of string

locationParametersobject

flowParametersobject

location*object

processedStatsobject

deliveryStatsobject

Request

JavaScriptCurlPython

const response = await fetch('<YOUR HOST>/v1/broadcasts', {
    method: 'POST',
    headers: {
      "x-api-key": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "location": {
        "id": "text"
      },
      "name": "text",
      "type": "client"
    }),
});
const data = await response.json();

Response

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": 0,
    "longitude": 0,
    "address": "text",
    "name": "text"
  },
  "flowParameters": {
    "flowToken": "text",
    "flowData": "text"
  },
  "location": {
    "id": "text"
  },
  "processedStats": {
    "totalCount": 0,
    "successCount": 0,
    "failureCount": 0
  },
  "deliveryStats": {
    "sentCount": 0,
    "deliveredCount": 0,
    "readCount": 0,
    "failedCount": 0,
    "repliedCount": 0
  }
}

GET<YOUR HOST>/v1/broadcasts/{broadcastId}

Authorization

api_key

Path parameters

broadcastId*string

Header parameters

Response

200

200 response

Body

application/json

idstring

name*string

type*enum

clientcontactclassretarget

statusstring

segmentsarray of object

targetClassobject

targetClassStatusenum

ALLWAITLISTEDBOOKEDVISITEDRESCHEDULEDNO_SHOWCANCELLED

retargetBroadcastobject

retargetEngagementTypeenum

sentdeliveredreadrepliednot-replied

scheduleDateTimestring

startedAtstring

completedAtstring

templateobject

headerMediaUrlstring

headerTextParametersarray of string

bodyTextParametersarray of string

buttonUrlParametersarray of string

locationParametersobject

flowParametersobject

location*object

processedStatsobject

deliveryStatsobject

Request

JavaScriptCurlPython

const response = await fetch('<YOUR HOST>/v1/broadcasts/{broadcastId}', {
    method: 'GET',
    headers: {
      "x-api-key": "text"
    },
});
const data = await response.json();

Response

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": 0,
    "longitude": 0,
    "address": "text",
    "name": "text"
  },
  "flowParameters": {
    "flowToken": "text",
    "flowData": "text"
  },
  "location": {
    "id": "text"
  },
  "processedStats": {
    "totalCount": 0,
    "successCount": 0,
    "failureCount": 0
  },
  "deliveryStats": {
    "sentCount": 0,
    "deliveredCount": 0,
    "readCount": 0,
    "failedCount": 0,
    "repliedCount": 0
  }
}

PUT<YOUR HOST>/v1/broadcasts/{broadcastId}

Authorization

api_key

Path parameters

broadcastId*string

Header parameters

Body

application/json

idstring

name*string

type*enum

clientcontactclassretarget

statusstring

segmentsarray of object

targetClassobject

targetClassStatusenum

ALLWAITLISTEDBOOKEDVISITEDRESCHEDULEDNO_SHOWCANCELLED

retargetBroadcastobject

retargetEngagementTypeenum

sentdeliveredreadrepliednot-replied

scheduleDateTimestring

startedAtstring

completedAtstring

templateobject

headerMediaUrlstring

headerTextParametersarray of string

bodyTextParametersarray of string

buttonUrlParametersarray of string

locationParametersobject

flowParametersobject

location*object

processedStatsobject

deliveryStatsobject

Response

200

200 response

Body

application/json

idstring

name*string

type*enum

clientcontactclassretarget

statusstring

segmentsarray of object

targetClassobject

targetClassStatusenum

ALLWAITLISTEDBOOKEDVISITEDRESCHEDULEDNO_SHOWCANCELLED

retargetBroadcastobject

retargetEngagementTypeenum

sentdeliveredreadrepliednot-replied

scheduleDateTimestring

startedAtstring

completedAtstring

templateobject

headerMediaUrlstring

headerTextParametersarray of string

bodyTextParametersarray of string

buttonUrlParametersarray of string

locationParametersobject

flowParametersobject

location*object

processedStatsobject

deliveryStatsobject

Request

JavaScriptCurlPython

const response = await fetch('<YOUR HOST>/v1/broadcasts/{broadcastId}', {
    method: 'PUT',
    headers: {
      "x-api-key": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "location": {
        "id": "text"
      },
      "name": "text",
      "type": "client"
    }),
});
const data = await response.json();

Response

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": 0,
    "longitude": 0,
    "address": "text",
    "name": "text"
  },
  "flowParameters": {
    "flowToken": "text",
    "flowData": "text"
  },
  "location": {
    "id": "text"
  },
  "processedStats": {
    "totalCount": 0,
    "successCount": 0,
    "failureCount": 0
  },
  "deliveryStats": {
    "sentCount": 0,
    "deliveredCount": 0,
    "readCount": 0,
    "failedCount": 0,
    "repliedCount": 0
  }
}

DELETE<YOUR HOST>/v1/broadcasts/{broadcastId}

Authorization

api_key

Path parameters

broadcastId*string

Header parameters

Response

200

200 response

Body

application/json

successboolean

Request

JavaScriptCurlPython

const response = await fetch('<YOUR HOST>/v1/broadcasts/{broadcastId}', {
    method: 'DELETE',
    headers: {
      "x-api-key": "text"
    },
});
const data = await response.json();

Response

200

{
  "success": false
}

GET<YOUR HOST>/v1/broadcasts/{broadcastId}/logs

Authorization

api_key

Path parameters

broadcastId*string

Query parameters

Header parameters

Response

200

200 response

Body

application/json

broadcastobject

recepientNamestring

countryCodestring

phonestring

Pattern: ^[0-9]+$

statusenum

readsentdelivered

replystring

errorstring

createdAtstring (date-time)

updatedAtstring (date-time)

Request

JavaScriptCurlPython

const response = await fetch('<YOUR HOST>/v1/broadcasts/{broadcastId}/logs', {
    method: 'GET',
    headers: {
      "x-api-key": "text"
    },
});
const data = await response.json();

Response

200

[
  {
    "broadcast": {
      "id": "text",
      "name": "text"
    },
    "recepientName": "text",
    "countryCode": "text",
    "phone": "text",
    "status": "read",
    "reply": "text",
    "error": "text",
    "createdAt": "2024-12-21T11:37:49.724Z",
    "updatedAt": "2024-12-21T11:37:49.724Z"
  }
]