Outbound Webhook: How To Send Referred Users Data Out

A webhook is a way for different applications to talk to each other or send data from one application to another in real-time.

In the case of Referral Factory, you can create an outbound webhook to send the data of your new referred user (or referred lead) to any endpoint – this could be an endpoint your developer creates or an endpoint you create in Zapier,  Airtable, Tray.io, or anywhere else that can receive an incoming webhook. 

Once you have created your webhook endpoint that can receive the data you're trying to send out, 

πŸ‘‰ Navigate to your campaigns tab in your dashboard

πŸ‘‰ Click on the Actions dropdown

πŸ‘‰ Choose Webhooks 


πŸ‘‰ Click on the "Create An Outbound Webhook" button. 


Steps to set up the outbound webhook πŸ‘‡

  1. Choose An Event
  2. Users To Send
  3. Endpoint & Method
  4. User Fields
  5. Hidden Fields
  6. Headers
  7. Finish

πŸ‘‰ Choose An Event

Follow the step-by-step prompts – start by choosing the event that your Webhook should fire on. 


πŸ‘‰ Users To Send
Select which users to send. In most cases, you only want to send the referred users' data out, as these are the new users that have been referred to you.

πŸ‘‰ Endpoint & Method

  1. Next, you will need to enter the endpoint that you created earlier. This must be a URL starting with HTTPS.
  2. You will then choose the request type – in most cases you will choose β€œSend me POST Request”.
  • GET- It requests data from a specified resource.
  • POST- It submits the processed data to a specified resource.


πŸ‘‰ User Fields

Next, you need to customize the request fields and choose what information you want to send through. Toggle on which request fields you would like to pass on. Remember you need to use the same naming convention as your endpoint in order to catch the data correctly. For example – if you have named the field email_address in Airtable, you need to make sure you name it email_address in your Webhook setup on Referral Factory.


πŸ‘‰ Hidden Fields

Next, you can use hidden fields if needed.


πŸ‘‰ Headers

Next, you can set up your webhook headers (not required).


πŸ‘‰ Finish

Once you’ve completed the above steps, make sure you give your Webhook a name that you can easily identify and click β€˜Save’.



Congrats. Your Webhook is now setup πŸ™Œ


Once you have created your Webhook or Webhooks, you can find them by navigating to your campaigns tab β†’ clicking the blue 'Actions' button β†’, and then clicking on Webhooks πŸ‘‡


Here is an example of how the request body is formatted in the request when data is sent to your endpoint. Data is sent via query parameters to your Webhook URL. 




Learn more about Webhooks and Referral Factory in this help guide.