Create, Schedule, and Send Messaging Campaigns in Zexa

A campaign in Zexa lets you send one message to hundreds or thousands of recipients at once. You pick the channel, choose a contact list, compose your message, and Zexa handles delivery and tracking.

Create a campaign

Open New Campaign

In the Zexa dashboard, go to Campaigns > New Campaign.

Choose a channel

Select the delivery channel for this campaign: SMS, WhatsApp, Telegram, Email, or Slack.

Select a contact list

Pick an existing contact list or upload a new CSV file. Zexa will count the eligible recipients before you send.

Compose your message

Write your message body. If you selected WhatsApp, choose an approved template instead of typing freeform text. See Templates for details.

Set a Sender ID

Choose the Sender ID that recipients will see in the From field. The Sender ID must already be approved for the selected channel. See Sender IDs.

Schedule or send immediately

Optionally set a future send time using the date/time picker, or click Send Now to dispatch the campaign immediately.

Monitor the campaign report

After sending, open the campaign report to track delivery, failures, and opt-outs in real time.

Campaign via API

Send a POST request to /campaigns to create and launch a campaign programmatically.

curl --request POST \
  --url https://api.zexa.ao/v1/campaigns \
  --header "Authorization: Bearer <api_key>" \
  --header "Content-Type: application/json" \
  --data '{
    "name": "June Promo",
    "channel": "sms",
    "contact_list_id": "lst_abc123",
    "sender_id": "ZEXA",
    "body": "Enjoy 20% off this weekend! Reply STOP to opt out.",
    "scheduled_at": null
  }'

import requests

url = "https://api.zexa.ao/v1/campaigns"
headers = {
    "Authorization": "Bearer <api_key>",
    "Content-Type": "application/json",
}
payload = {
    "name": "June Promo",
    "channel": "sms",
    "contact_list_id": "lst_abc123",
    "sender_id": "ZEXA",
    "body": "Enjoy 20% off this weekend! Reply STOP to opt out.",
    "scheduled_at": None,
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

A successful response returns a campaign object:

{
  "id": "cmp_xyz789",
  "status": "processing",
  "name": "June Promo",
  "channel": "sms",
  "total_recipients": 1500,
  "created_at": "2026-06-24T10:00:00Z"
}

Check campaign status

Retrieve the current status and delivery metrics for any campaign with a GET request:

curl

curl --request GET \
  --url https://api.zexa.ao/v1/campaigns/cmp_xyz789 \
  --header "Authorization: Bearer <api_key>"

{
  "id": "cmp_xyz789",
  "name": "June Promo",
  "status": "sent",
  "total_recipients": 1500,
  "delivered": 1463,
  "failed": 37,
  "created_at": "2026-06-24T10:00:00Z",
  "sent_at": "2026-06-24T10:02:15Z"
}

Campaign statuses

Status	Description
`draft`	The campaign has been created but not yet sent or scheduled.
`scheduled`	The campaign is queued and will be dispatched at the time set in `scheduled_at`.
`processing`	Zexa is actively dispatching messages to recipients.
`sent`	All messages have been submitted to the delivery network.
`failed`	The campaign encountered a fatal error and could not be sent. Contact support.

Scheduling

Set the scheduled_at field to an ISO 8601 timestamp to delay dispatch:

{
  "scheduled_at": "2026-07-01T08:00:00Z"
}

All times are interpreted as UTC. Pass null for scheduled_at to send immediately. You can update a scheduled campaign’s send time via PATCH /campaigns/{id} as long as its status is still scheduled.

Always include an opt-out instruction in SMS campaign messages — for example, “Reply STOP to unsubscribe.” This is a best practice in most markets and required by carriers in many regions.

Campaigns cannot be cancelled or modified once their status changes to processing. Review your recipient list, message body, and Sender ID carefully before sending.

Get Started

Channels

Campaigns & Messaging

Account & Billing

Help

Create, Schedule, and Send Messaging Campaigns in Zexa

Create a campaign

Campaign via API

Check campaign status

Campaign statuses

Scheduling

Contacts

Sender IDs

Templates

​Create a campaign

​Campaign via API

​Check campaign status

​Campaign statuses

​Scheduling

Contacts

Sender IDs

Templates

Create a campaign

Campaign via API

Check campaign status

Campaign statuses

Scheduling