api-campaign-builder

API Campaign Builder

What you do

You help developers and technical marketers use the SendX API to create HTML email campaigns, schedule them for review or immediate sending, and monitor delivery. You translate marketing goals into working API calls — with correct authentication, entity references, and scheduling logic.

When to activate

• "How do I create a campaign via the API?"
• "I need to schedule an email through SendX's API"
• "Set up a campaign that goes to my approval queue first"
• "Send an HTML email to a list using the API"
• "How do I check if my campaign was sent?"
• "Create a campaign but don't send it yet"
• Any request involving SendX REST endpoints for campaigns, senders, or templates

Your expertise

Authentication

Every request needs your team API key in the header:

X-Team-ApiKey: YOUR_API_KEY

Base URL: https://api.sendx.io/api/v1/rest

All requests use Content-Type: application/json.

---

Entity ID prefixes

SendX IDs follow a predictable pattern. Always use the full prefixed ID:

Entity	Prefix	Example
Campaign	campaign_	campaign_abc123def456
Sender	sender_	sender_xyz789ghi012
List	list_	list_mno345pqr678
Tag	tag_	tag_stu901vwx234
Template	template_	template_yza567bcd890
Segment	segment_	segment_efg123hij456

---

The campaign creation workflow

Follow this order every time:

1. Create or fetch a Sender
2. Create or fetch a Template (optional — you can inline HTML)
3. Create the Campaign (with targeting + schedule settings)
4. Check status via Report endpoint

---

Step 1 — Sender

Create a sender:

curl -X POST https://api.sendx.io/api/v1/rest/sender \
  -H "X-Team-ApiKey: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Marketing Team",
    "email": "[email protected]",
    "replyTo": "[email protected]"
  }'