Atlas B7oxwnqtho

OutboundSync Help Center

Webhooks are a powerful way to receive real-time notifications about events happening within your Smartlead account.

By properly configuring your webhooks with OutboundSync, you can automate workflows, integrate with your CRM, generate reporting on your campaign attribution, and more.

A webhook is an HTTP callback that sends data to a specified URL when certain events occur in your Smartlead account.

Instead of constantly polling Smartlead for updates, webhooks allow you to receive event notifications instantly, enabling seamless integration with your applications.

Smartlead allows you to configure webhooks at three different levels:

: Applies to all activities under your user account.

: Applies to all activities under a specific client.

: Applies to activities within a specific campaign.

: Log in to your Smartlead account and go to the 

: Choose whether you want to set up a webhook at the user, client, or campaign level.

An agency (or client of an agency) will typically use the client-level webhook to send that data to OutboundSync.

A team using a single Smartlead account will typically set up a single user-level webhook to send that data to OutboundSync. 

If you are using client-level webhooks, DO NOT use any user-level webhooks. If you do, your client-level webhook payloads will be blocked. OutboundSync will not receive the data from Smartlead and your clients' data will not sync.

: Provide the endpoint URL where you want to receive the webhook notifications. (This is generated by OutboundSync.)

: Choose the specific events you want to receive notifications for. You may also want to enable Category-Based Filters in OutboundSync.

Now you need to decide how you want to set your newly created webhook in Smartlead. Smartlead provides two ways of doing this.

Generate a single webhook for your entire account by creating a Client. You can do this by creating a ghost or dummy client account for yourself. This way, every time you run a campaign, you can attach yourself as a client and use the same webhook.

Alternatively, you can generate one or multiple webhooks and attach them to each campaign. This is more manual and generally not advised unless you have campaigns dedicated to each sales rep. To do this, for each campaign, go to Campaign Settings then click the Webhooks tab, click Add webhook, and paste the webhook URL from OutboundSync. Then select which events to sync.

While it depends on your use case, most users choose to create a User or Client webhook. 

Smartlead supports a variety of event types that you can subscribe to:

For a complete list of event types and their payloads, refer to 

Please note that regardless of the number of webhook settings configured, Smartlead will only send notifications for two types: One for Slack and the other for Normal. The priority algorithm logic is outlined below.

If a user has a user-level webhook configured, notifications will be sent to that URL. However, if the user desires webhook notifications at the client level, kindly request the user to remove the user-level webhook.

If a user-level webhook exists, client or campaign level webhooks will not function.

For users with multiple user-level webhooks, Smartlead will select the last updated one.

For users with multiple client-level webhooks, Smartlead will also select the last updated one.

The same logic applies to campaigns: If a customer has multiple campaign-level webhooks (without user or client level), Smartlead will choose the last updated one.

: Note that Smartlead does not maintain any data about webhook logs. OutboundSync logs are available and we can help you review them along with our internal server diagnostic logs. 

: As of February 20, 2025, Smartlead will retry sending webhook payloads up to 5 times with a 300 second (5 minute) intervals between attempts. OutboundSync is always developing new methods to ensure we have the latest data available from Smartlead. 

: Implement proper security measures on your Smartlead account to that will be sending webhook payloads to OutboundSync.

: Before deploying to production, test your webhooks using Smartlead's webhook test payload function and OutboundSync's 

: If setting up webhooks at multiple levels, use unique URLs to distinguish between different event sources. Remember that a user-level webhook will override any lower level webhook. 

: Keep an eye on your records in your CRM and history in OutboundSync. If anything seems off, contact us so we can help you diagnose the issue. 

Webhooks are an integral part of automating your workflows with Smartlead and your CRM. By understanding how they work and setting them up correctly, you can run a fully integrated outbound operation that integrates with your automations, workflows, and sales processes.

Smartlead webhook guide

Here are step-by-step instructions on how to connect Smartlead to OutboundSync via API key. This is necessary to do things like creating blocklists or apply category-based filters. 

First, log in to Smartlead and go to your 

If you do not already have a Smartlead API key, then generate a new one and copy it.

Step 2. Add your API key in OutboundSync.

Next, login to OutboundSync and click the 

OutboundSync will check your API key before saving it. If your API key fails, it will not be saved in OutboundSync.

You can always come back to OutboundSync and click the 

 button to verify that your API Key is still valid and active. 

In this page, you can also check your Lead Categories or Statuses. You can 

Connect your Smartlead API key

The Additional Endpoints feature in OutboundSync allows users to forward Smartlead payloads to multiple third-party webhook URLs or endpoints, such as Make.com, Zapier, Clay, and other no-code tools. 

This feature helps extend the reach of your outbound marketing data for automation, reporting, or lead enrichment across different platforms.

This feature was introduced to overcome Smartlead's limitation of using only one webhook per event type. Refer here to learn more about 

, you can route specific event data—such as 

This flexibility ensures that even with Smartlead's restrictions, users can seamlessly integrate their workflows by distributing critical data to various tools for further processing.

: Automatically send replies from your email campaigns to another platform for logging and follow-up.

: Trigger third-party services to enhance or enrich your lead data based on specific events.

: Distribute different events to reporting tools, ensuring you capture detailed metrics on campaign performance across platforms.

The webhook URL must be live at the time that you add it. OutboundSync will send a test payload to verify we can deliver payloads to this webhook URL.

 dropdown to choose from the list of webhooks you've connected.

 filter to specify which events you want to trigger payloads for. Available event types include:

Once you’ve made your selections, click 

to include additional endpoints, you can do so in the 

Once your additional endpoints are configured, Smartlead payloads will automatically be sent to the selected webhooks based on your event triggers.