Authentication
Symptoms:- 401 responses
- token appears valid but request fails
- verify Authorization header format:
Bearer <token> - confirm token is not expired
- confirm route group matches token scope
- issue a fresh token
- retry request with explicit auth header
- validate environment base URL and route prefix
Validation Errors
Symptoms:- 400 responses for payload shape
- missing required fields
- validate required fields for endpoint
- validate enum values and case-sensitive strings where applicable
- validate date and timezone formats
- start from a known-good minimal payload
- add fields incrementally until desired shape is reached
- keep payload examples versioned by client SDK or integration source
Event Delays
Symptoms:- event accepted but not visible in canonical list
- inspect Incoming Events status first
- check process_error and retryable
- confirm event_id linkage for processed items
- if failed terminal, fix payload and resend
- if processing, continue polling within expected window
- validate idempotency strategy to avoid duplicate logical submissions
Campaign Send Issues
Symptoms:- campaign launch fails
- campaign remains scheduled unexpectedly
- recipients remain queued or fail in batches
- sender domain verification
- provider configuration present
- audience mode and snapshot validity
- scheduled_for value relative to current time
- correct prerequisites and relaunch
- test with a smaller audience
- monitor recipient-level outcomes for first successful run
Workflow Delivery Gaps
Symptoms:- expected workflow email not delivered
- execution marked skipped
- contact has valid email
- contact is subscribed
- workflow default template exists
- queue item status and process_error fields
- fix contact eligibility
- fix template or provider config
- retrigger with a controlled test event