Skip to main content

Inbound Webhook Setup

Transfer prospects and leads from any source directly into Unstuck Engine. The inbound webhook accepts data from any system - automatically enriching each contact with 50+ data points, scoring against your ICP models, and routing through your workflows.

Ivan Kovpak avatar
Written by Ivan Kovpak
Updated over 3 months ago

Quick Steps

  1. Navigate to Signals tab

  2. Find Extract ICP from your incoming Webhook signal

  3. Copy your unique webhook URL from the popup

  4. Configure your system to send data in required format

  5. Click Run to activate

Detailed Instructions

1. Access Inbound Webhook Signal

Navigate to the Signals tab where you manage all signal sources. Locate the signal titled "Extract ICP from your incoming Webhook" in the list.

2. Open Webhook Configuration

Click the Run button next to the incoming webhook signal. A popup window titled "Set up Webhook" will appear.

3. Copy Your Webhook URL

In the popup, you'll see your unique webhook endpoint (each customer has their own unique URL):

https://webhook.unstuckengine.com/[your-unique-id]

Click the copy button to copy this URL. You'll need to configure your external systems to send POST requests to this endpoint.

4. Configure Your System

Set up your system to send data to the webhook URL using the required JSON structure:

{ "intent": "1", "linkedInProfileUrl": "https://www.linkedin.com/in/username", "source": "your_source_identifier", "additional_info": "any_custom_data" }

5. Activate the Webhook

After configuring your external system, click Run to activate the webhook and start receiving signals.

Primary Use Cases

1. Data Transfer from Customer Systems

Import prospects and leads from any of your existing systems:

  • CRM platforms (HubSpot, Salesforce, Pipedrive)

  • Marketing automation tools

  • Customer databases

  • Partner portals

  • Support systems

2. Custom First-Party Signals

Capture proprietary engagement signals unique to your business:

  • Digital Sales Room activity

  • Newsletter subscriptions

  • Product usage events

  • Content engagement

  • Custom tracking events

Required Webhook Structure

Your system must send a JSON payload with these four fields:

Intent Field

The intent field defines the signal type:

  • "1" - 1st-party intent (direct engagement with your company)

  • "2" - 2nd-party intent (engagement through partners/affiliates)

  • "3" - 3rd-party intent (external signals from third-party sources)

  • "0" - Zero intent (no specific intent signal)

LinkedIn Profile URL

The linkedInProfileUrl field should contain the full LinkedIn profile URL of the person:

"linkedInProfileUrl": "https://www.linkedin.com/in/username"

Source Field

The source field identifies where the signal originated. Examples:

  • "hubspot" - HubSpot CRM

  • "salesforce" - Salesforce

  • "form_submit" - Website form

  • "newsletter" - Newsletter signup

  • "digital_room" - Digital Sales Room

  • Any custom identifier for your system

Additional Info Field

The additional_info field is flexible and can store any custom data you need:

  • Custom tags or labels

  • Event metadata

  • Internal IDs

  • Tracking parameters

  • Context information

  • Any data relevant to your workflows

This field is optional and can be left empty ("") if not needed.

Complete Example Payloads

CRM Import

{ "intent": "1", "linkedInProfileUrl": "https://www.linkedin.com/in/johndoe", "source": "salesforce", "additional_info": "lead_id_SF-12345" }

Newsletter Subscription

{ "intent": "1", "linkedInProfileUrl": "https://www.linkedin.com/in/janedoe", "source": "newsletter", "additional_info": "enterprise_newsletter_Q4" }

Digital Sales Room Activity

{ "intent": "1", "linkedInProfileUrl": "https://www.linkedin.com/in/user123", "source": "digital_room", "additional_info": "viewed_pricing_proposal" }

Partner Referral

{ "intent": "2", "linkedInProfileUrl": "https://www.linkedin.com/in/referred_user", "source": "partner_portal", "additional_info": "partner_abc_corp" }

How Unstuck Engine Processes Your Webhook

When Unstuck Engine receives your webhook:

  1. Validates the payload - Checks required fields are present

  2. Identifies the person - Uses LinkedIn URL to find or create prospect profile

  3. Enriches the data - Adds 50+ data points about the person and company

  4. Scores against ICPs - Evaluates fit with all your ICP models

  5. Matches personas - Identifies matching buyer personas

  6. Assigns engagement stage - Places in appropriate stage (A-E) based on all signals

  7. Triggers downstream actions - Sends enriched data via outbound webhooks

Webhook Response

Unstuck Engine returns:

  • 200 OK - Signal successfully received and processed

  • 400 Bad Request - Missing required fields or invalid format

  • 401 Unauthorized - Invalid webhook endpoint

  • 500 Internal Server Error - Processing error (will retry)

Did this answer your question?