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

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

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