Create a Multi-send Campaign
Multi-send creates one Campaign and one child Message per recipient, each with its own Content. Recipients are addressed by External user ID. There is no RPC-style `/send` path.
Multi-send creates one Campaign and one child Message per recipient, each with its own Content. Recipients are addressed by External user ID. There is no RPC-style /send path.
bearerAuthAuthorizationBearer <API key>Project API key (cr_sk_...)
Idempotency-Key?stringProject-scoped retry key. Same key + same body replays the stored 202 response. Same key + different body returns 409 idempotency_conflict. Same key while the first request is incomplete returns 409 idempotency_in_progress.
application/json- body
Multi-send body. Each recipient is one Contact (by External user ID) with its own Content. The API creates one Campaign and one Message per recipient. Recipients are capped at 10,000 (same Contact cap as Single-send to.external_user_ids).
channel*"push"Required. Only push is accepted in V1.
"push"name?stringOptional Campaign label for inspection
recipients*array<>Per-Contact Contents. Maximum 10,000 recipients.
1 <= items <= 10000Accepted (new create or idempotent replay of a completed key). Replay returns the original CampaignAccepted body.
application/json- response
campaign_id*stringuuidchannel*stringstatus*string"queued""processing""completed""failed""cancelled"message_count?integermessages*array<>curl -X POST 'https://api.comraid.io/campaigns' \ -H 'Content-Type: application/json' \ -d '{ "channel": "push", "recipients": [ { "external_user_id": "string", "content": { "push": {} } } ]}'{ "campaign_id": "0a1b2c3d-4e5f-6789-abcd-ef0123456789", "channel": "push", "status": "queued", "message_count": 2, "messages": [ { "message_id": "11111111-1111-4111-8111-111111111111", "external_user_id": "user_a", "status": "processing", "delivery_count": 1 }, { "message_id": "22222222-2222-4222-8222-222222222222", "external_user_id": "user_b", "status": "processing", "delivery_count": 1 } ]}Upload a push image POST
Multipart upload of a JPEG or PNG (max 1MB). Field name must be `file`. Returns a project-scoped `asset_id` and a publicly reachable `url` suitable for `content.push.image_url`. Requires S3-compatible storage configuration. Dashboard session uploads use `/dashboard/projects/{projectId}/media` and are not part of this public specification.
Get Campaign and child Messages GET
Returns the Campaign, its child Messages, `message_counts` keyed by Message status (`scheduled`, `preparing`, `processing`, `completed`, `failed`, `cancelled`), and `delivery_totals` (nested Delivery rollups + CTR summed across child Messages; same nesting as Message `status_summary`).