We are now open for everyone. Get Started.

Create Batch Campaign

Development

https://dev.api.ziett.co

POST

/c/v1/campaigns/batch

Last modified:2026-03-22 10:48:32

Initiate a large-scale messaging campaign for multiple recipients. The system will process the list, validate numbers, and queue them for delivery.

Campaign Lifecycle

Creation: The campaign is created with status PENDING.

Processing: Recipients are analyzed, and costs are debited from the organization's wallet.

Queueing: Individual messages are generated and enqueued.

Completion: Once all messages are enqueued, the campaign status moves to COMPLETED.

Limits

Recipients: You can send to up to 1000 recipients in a single batch request.

Rate Limit: This endpoint is limited to 10 requests per minute per API Key.

Request

Authorization

API Key

Add parameter in header

X-API-KEY

Example:

X-API-KEY: ********************

Body Params application/jsonRequired

Examples

Responses

🟢202Accepted

application/json

Successful Response

Body

🟠422Parameter Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://dev.api.ziett.co/c/v1/campaigns/batch' \
--header 'X-API-KEY: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "string",
    "country_alpha2": "st",
    "content": "string",
    "channel_type": "SMS",
    "recipients": [
        "string",
        "string"
    ]
}'

Response Example

202 - Example 1

null

Modified at 2026-03-22 10:48:32

List Organization Campaigns

List Campaign Messages

Create Batch Campaign

Campaign Lifecycle#

Limits#

Request

Responses

Campaign Lifecycle

Limits