Campaign Dispatch API

What is Campaign Dispatch API?

The Campaigns API allows you to push recipient arrays, specify dynamic merge tags (`{{first_name}}`, `{{company}}`), and select target SMTP server pools.

Every campaign request is automatically queued in Horizon background workers (`SendCampaignBatchJob`), ensuring zero HTTP timeout delays.

You can specify custom throttle delays (`gap_min` and `gap_max`) directly in the API payload.

Key Features

Dynamic Merge Tag Substitution

Inject custom recipient properties like first_name, company, and domain dynamically into campaign email templates.

Custom Throttle Delays

Set randomized gap intervals between outgoing emails directly via API payload parameters.

How It Works

1. Formulate a JSON payload containing campaign subject, template body, and recipient arrays.

2. Send a POST request to `https://inbox.staurax.com/api/v1/campaigns/dispatch`.

3. Staurax Mail assigns a Horizon Batch ID and starts queued background dispatches.

Code Example & API Usage

                                curl -X POST https://inbox.staurax.com/api/v1/campaigns/dispatch \
  -H "Authorization: Bearer stx_live_9f8a3c2b1e4d5" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Q3 Enterprise Outreach",
    "smtp_group_id": 4,
    "recipients": [
      {"email": "[email protected]", "name": "Alex", "company": "Acme Corp"}
    ],
    "gap_min": 30,
    "gap_max": 90
  }'                            

Automate Your Cold Email Infrastructure

Connect your internal CRM or lead scrapers directly to Staurax Mail Campaigns API.

Get Started