Troubleshooting

Authentication

Invalid API key:

• Secret keys start with sk_, public keys with pk_
• Use Authorization: Bearer sk_your_secret_key

Wrong key type:

• Public keys (pk_) only work with /v1/track
• All other endpoints require secret keys (sk_)

Emails not sending

1. Billing limit reached — Check Settings → Billing
2. Template not found — Verify template ID exists
3. Contact unsubscribed — Marketing templates skip unsubscribed contacts

Emails going to spam

1. Set up a custom domain
2. Clean your list (remove bounces)
3. Warm up new domains gradually

Workflows not triggering

1. Workflow not enabled — Check toggle is ON
2. Wrong event name — Names are case-sensitive
3. Already entered — If re-entry disabled, contact can only enter once

Rate limiting (429)

• Wait and retry
• Batch multiple recipients in one request
• Spread requests over time

Request IDs

Every API response includes X-Request-ID header. Include this when contacting support.