Webhook integration is the easiest and the most flexible way to integrate ReferralMagic into any service you are using.

<aside> 💡 If you don't know what Webhook is, please refer to Wikipedia for the quick explanation.

</aside>

With webhook integrations, you can get notified about certain ReferralMagic events almost instantly on your own system. Currently, the following webhook events are available for the integration:

Webhook Events

Setting Up a Webhook Integration

Follow these easy steps to setup a webhook integration:

  1. Login to your ReferralMagic account if you haven't logged in yet.

  2. Go to the dashboard of your referral tracking campaign

  3. Click "Webhooks" link on the right side:

    https://d33v4339jhl8k0.cloudfront.net/docs/assets/58bea548dd8c8e56bfa83e96/images/5a8e91982c7d3a0806494473/file-s53Lw166sS.png

  4. Enter the target URL where you want to fetch webhook data from ReferralMagic. Just to give it a try, you can generate a request URL on RequestBin and use it for testing purposes.

    https://d33v4339jhl8k0.cloudfront.net/docs/assets/58bea548dd8c8e56bfa83e96/images/5a8e91fb2c7d3a0806494479/file-0xBcyojElR.png

  5. Choose the trigger. Based on your selection, ReferralMagic will send data to your target webhook URL once that selected event occurs:

    https://d33v4339jhl8k0.cloudfront.net/docs/assets/58bea548dd8c8e56bfa83e96/images/5a8e923204286305fbc9bec6/file-xt9yjFo8pd.png

  6. Click "Add" button. You will see the webhook on the list:

    https://d33v4339jhl8k0.cloudfront.net/docs/assets/58bea548dd8c8e56bfa83e96/images/5a8e925b04286305fbc9bec7/file-lQmpZcMNcR.png