Batch Send

Use batch send when an application needs to queue multiple API-driven messages.

Example request

curl -X POST "https://app.yourdomain.com/api/batch_mail/api/batch_send" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $PING8_API_KEY" \
  -d '{
    "recipients": [
      { "email": "first@example.com", "attribs": { "first_name": "First" } },
      { "email": "second@example.com", "attribs": { "first_name": "Second" } }
    ]
  }'

Batch safety

• Validate recipients before sending.
• Keep batches small enough to retry intentionally.
• Do not retry blindly unless your integration is idempotent.
• Watch delivery telemetry after batch sends.

When to use campaigns instead

Use Email Marketing campaigns when the audience comes from PING8 contact groups, tags, and marketing templates. Use batch send when the application owns the recipient list and event trigger.