> ## Documentation Index
> Fetch the complete documentation index at: https://support.tapfiliate.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks and Event-Driven Workflows

> This guide walks you through setting up webhooks and event-driven workflows in Tapfiliate.

October 22, 2026

In this article, we will cover:

1. [Why webhooks are powerful for Tapfiliate automations](#h_a37f20858e)
2. [What you need before setting up event-driven workflows](#h_3d8adfa184)
3. [Step-by-step webhook trigger setup](#h_9aa96640bd)
4. [Two detailed real-world example workflows](#h_5756d5b918)
5. [How to test and verify your setup](#h_c5b9545d1a)

***

## Webhooks & Event-Driven Workflows Overview

Tapfiliate’s **Triggers & Webhooks** feature allows you to automatically react when something happens in your affiliate program, such as a conversion being created or an affiliate signing up.\

Instead of manually exporting data or polling the API, Tapfiliate can **push event data instantly** to:

* External systems (CRMs, Slack, analytics tools, etc.)
* Internal workflows using Tapfiliate’s own REST API

This enables fully automated, event-driven affiliate operations.

***

## Why Use Webhooks and Event-Driven Workflows

##### Pros

* **Real-time automation**: Events like conversions or affiliate sign-ups propagate immediately to other systems or workflows.
* **Internal event chaining**: One event can natively initiate another (e.g., create a commission after an affiliate is added)
* **External integrations**: Sync Tapfiliate events with CRMs, support tools, internal dashboards, and more

##### Use Cases

* Automatically add new affiliates to an external CRM
* Create affiliate prospects when a customer is created.
* Trigger Slack or email alerts for large conversions
* Sync commission updates to accounting tools.

### Prerequisites for Using Webhooks

Before setting up webhooks, make sure you have:

* A Tapfiliate account with access to **Triggers**
* Your **Tapfiliate API key** (Profile → API key)
* An **endpoint URL** that can receive HTTP requests
* (Optional) A tool like Zapier, Make, or a custom backend

***

## Step-by-Step: Creating a Webhook Trigger

### Step 1: Create a New Trigger

1. Go to **Tapfiliate Dashboard → Triggers**
2. Click **New Trigger**
3. Enter a title and description for your workflow

### Step 2: Choose the Trigger Event

Select when the trigger should fire, for example:

* Conversion created
* Affiliate created
* Commission updated

This determines **what event starts your workflow**.

### Step 3: Apply Filters (Optional)

You can limit when the trigger fires, such as:

* Only for a specific program
* Only if commission value is above a certain amount

![New Filters Webhooks](https://mintcdn.com/tapfiliate-help/MVkOJeNPAETB-f-T/images/13389820/01-skitch.png?fit=max\&auto=format\&n=MVkOJeNPAETB-f-T\&q=85\&s=2c351a58f797cd8cd408b0a00582bc0c)

Filters help avoid unnecessary webhook calls.

### Step 4: Choose the Webhook Action

Under **Do the following…**, choose one of the following:

* **Webhook** - sends a predefined payload
* **Webhook (custom)** - lets you define headers and payload structure

Use **Webhook (custom)** when you need authentication headers or a specific JSON format.

![](https://mintcdn.com/tapfiliate-help/MVkOJeNPAETB-f-T/images/13389820/02-eb983e18-b7e3-4883-80ca-893fac8a9466.png?fit=max\&auto=format\&n=MVkOJeNPAETB-f-T\&q=85\&s=65d6693a682be1869ede9c048fe1d86f)

### Step 5: Configure the Webhook

* Enter the destination **URL** (a public http\:// or https\:// address; requests to private or internal network addresses are blocked)
* (Optional) Add headers like Authorization or Content-Type
* Use merge tags to include dynamic Tapfiliate data in the payload

### Step 6: Save and Test

* Save the trigger
* Use **Test action** to verify the webhook fires correctly

*Note: the current test limit is set to 20 requests/day.*

***

## Two detailed real-world example workflows

### Using triggers to sync registered affiliates to external CRM platform (Hubspot):

Use case: Immediately add or update every newly created affiliate as a contact in HubSpot CRM. This is used to directly sync anyone signing up to your affiliate program directly to your CRM without any manual intervention.\

Setup:

1. Trigger Event: Affiliate created - this fires whenever an affiliate is created in the system.
2. Use the Hubspot's "create a contact" API endpoint as the url of the webhook, and add the headers and Body of the API.
3. You can dynamically send data in your webhook by using the "tags" available in the webhooks URL and Body.
4. Complete the setup and hit "test action" to test your webhook.

![](https://mintcdn.com/tapfiliate-help/MVkOJeNPAETB-f-T/images/13389820/03-c35b460f-ce6f-4bb5-a0ad-1ffb48b8cc41.png?fit=max\&auto=format\&n=MVkOJeNPAETB-f-T\&q=85\&s=086130224a367a6263e171a3cb54b4cb)

***

### Using triggers to automate affiliate prospect creation when a customer is created (Internal API):

Use case: Immediately add or update every newly created customer as an affiliate prospect in Tapfiliate account. This adds each customer as an affiliate prospect and triggers a mail to refer their peers to become affiliates in Tapfiliate. This feature can help automate your referral process which can be used to promote your program via your customers.\

Setup:

1. Trigger Event: Customer created — this fires whenever a customer is created in the system.
2. Use Tapfiliate's "[create an affiliate prospect](https://developers.tapfiliate.com/api-reference/affiliate-prospects/create-an-affiliate-prospect)" API endpoint as the url of the webhook, and add the headers and Body of the API.
3. You can dynamically send data in your webhook by using the "tags" available in the webhooks URL and Body.
4. Complete the setup and hit "test action" to test your webhook.

![](https://mintcdn.com/tapfiliate-help/MVkOJeNPAETB-f-T/images/13389820/04-3f092e84-260a-4f0c-8d01-5f168b4985ef.png?fit=max\&auto=format\&n=MVkOJeNPAETB-f-T\&q=85\&s=f14b1833f4acf82d3bd28e6bac86e778)

***

## How to Test and Verify Your Webhooks

1. Trigger a test event (create a test conversion or customer)
2. Use the **Test action** button in Triggers
3. Confirm the receiving system gets the payload
4. Check logs or responses for errors
5. Verify the expected action occurred (CRM entry created, prospect added, message sent, etc.)

***

**Need More Help?**

If you have questions about building advanced event-driven workflows, chaining internal triggers, or connecting Tapfiliate to third-party tools, contact us at **[support@tapfiliate.com](mailto:support@tapfiliate.com)**, we’re happy to help.

***


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.