Webhooks

Stop polling for changes. Webhooks push events to your systems the moment they happen – so your tools can react instantly.

What You Get Notified About

• Affiliate events: new signups, profile updates, status changes
• Referral events: new referrals, conversions
• Commission events: created, approved, rejected
• Payout events: initiated, completed, failed

Setting Up Webhooks

1. Go to Connect → Webhooks in your dashboard
2. Click Add Endpoint
3. Enter your URL and select the events you want
4. Save and test your endpoint

Security

Every webhook payload is signed with HMAC-SHA256. Verify the signature to ensure requests actually come from Affonso.

Failed deliveries are retried with exponential backoff. You can also replay failed events from the delivery log.

Common Use Cases

• Slack notification when a new affiliate joins
• CRM update when a referral converts
• Custom email when a payout is processed
• Analytics tracking for every conversion

Full Documentation

For payload formats, signature verification, and event details:

→ docs.affonso.io/webhooks