Troubleshooting
Webhook Not Being Received
Webhook Not Being Received
Ensure your webhook URL is correctly configured in Organization settings and is publicly accessible over HTTPS.
Receiving Duplicate Events
Receiving Duplicate Events
Implement idempotency in your webhook handler using the
idempotency_key field to deduplicate events (for older payloads without it, combine campaign_affiliate_id, event, and occurred_at).Webhook Failing with Timeout
Webhook Failing with Timeout
Your endpoint must respond within 10 seconds. Consider processing webhooks asynchronously and returning a 200 response immediately.
Got removed when changing a code
Got removed when changing a code
Changing a creator’s affiliate code does not remove them from the campaign. Status webhooks (
activated / removed / left) only fire on status changes. Code changes emit campaign_affiliate.code_updated instead. If you received a removed event around a code change, check whether the creator was also removed (or a delayed status webhook from an earlier action was delivered).