Marketing Campaigns

A campaign is any message sent to multiple recipients. While transactional messagesare 1:1 (one message to one recipient triggered by an event), campaigns are 1:many — one message delivered to a list of people or a contact group. Both use the same POST /v1/messages endpoint.

You can target campaigns by passing multiple phone numbers in toNumbers, contact group IDs in groupIds, or both together in the same request.

Send to a contact group

The most common approach. Create groups via the Contact Management API, then target them by ID.

cURL

Copy

curl --request POST \
     --url https://a.eztexting.com/v1/messages \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --user 'your_username:your_password' \
     --data '{
  "groupIds": [
    "987654"
  ],
  "message": "Flash sale! 20% off all plans this weekend. Use code FLASH20 at checkout. Reply STOP to opt out.",
  "messageType": "SMS",
  "companyName": "Acme Co"
}'

Send to a list of numbers

When your recipient list comes from an external system and you don't need to maintain contact groups in EZ Texting.

cURL

Copy

curl --request POST \
     --url https://a.eztexting.com/v1/messages \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --user 'your_username:your_password' \
     --data '{
  "toNumbers": [
    "15551234567",
    "15559876543",
    "15551112222"
  ],
  "message": "Your table is ready! Head to the host stand when you arrive.",
  "messageType": "SMS",
  "companyName": "Downtown Grill"
}'

Message templates

Templates let you define reusable campaign content and reference it by ID when sending. Create a template once, then use it across multiple campaigns for consistent branding. Templates require name and message fields, and optionally accept companyName, mediaFileId, and mediaFileUrl.

cURL

Copy

curl --request POST \
     --url https://a.eztexting.com/v1/message-templates \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --user 'your_username:your_password' \
     --data '{
  "name": "Weekly Newsletter",
  "message": "This week at Acme Co: new features, tips, and a special offer just for subscribers. Details: https://example.com/newsletter",
  "companyName": "Acme Co"
}'

Scheduling

Include sendAt with an ISO 8601 timestamp to schedule a campaign. Omit it to send immediately. Cancel a scheduled campaign with DELETE /v1/messages before it sends. When scheduling for recipients across time zones, consider segmenting your audience into regional groups and scheduling each separately.

MMS campaigns

Set messageType to "MMS" and include media via mediaUrl or mediaFileId. For campaigns, pre-uploading media via POST /v1/media-filesis recommended — when sending to many recipients, an external URL that becomes temporarily unavailable could cause delivery failures.

Campaign reporting

After a campaign sends, use the reporting endpoints to measure performance.

cURL

Copy

curl --request GET \
     --url https://a.eztexting.com/v1/message-reports/123456789 \
     --header 'accept: application/json' \
     --user 'your_username:your_password'

Campaign history / listing campaigns

Retrieve a paginated list of all campaigns you've sent. Use this endpoint to build a campaign history view, audit past sends, or find the ID of a specific campaign for reporting.

cURL

Copy

curl --request GET \
     --url https://a.eztexting.com/v1/campaign-info \
     --header 'accept: application/json' \
     --user 'your_username:your_password'

Consent and compliance

• Recipients must have explicitly opted in to receive promotional messages
• Honor opt-outs immediately — STOP is processed automatically by EZ Texting
• Include your companyName so recipients know who the message is from
• Include opt-out instructions in your first message to new subscribers
• Respect quiet hours (typically 8 AM–9 PM in the recipient's time zone)

Error handling

Keywords for list growth

Keywords allow contacts to opt in to your groups by texting a word (e.g., “TEXT ALERTS to 123456”). You can use keywords in campaigns to encourage sign-ups for future marketing. For details on setting up keywords and automation rules, see the Automations guide.

Next steps

• Transactional Messaging — Send 1:1 event-driven messages
• Contact Management — Build and organize the groups your campaigns target
• Conversational Messaging — Manage replies from campaign recipients
• Automations — Grow your list with keywords and automate follow-ups
• API Reference — Full interactive endpoint documentation