Articles on: Integrations

Webhook Receiver: How to Push Data to Breakcold from ANY Software

Automatically create or update records in Breakcold when external tools send data via webhooks.


Overview

The Webhook Receiver lets any external software push data into Breakcold by sending a POST request with a JSON payload to your unique webhook URL. When data arrives, Breakcold automatically creates or updates records (People, Companies, or Deals) based on the payload.
This works with any software that can send webhooks — form builders, automation tools, lead generation platforms, custom scripts, and more.
Breakcold offers two mapping modes to process incoming data:

  • Smart (AI) — AI automatically analyzes the payload, extracts relevant fields, and maps them to your record fields
  • Manual Mapping — You manually map each payload field to a specific record field for full control

Accessing the Webhook Receiver

  1. In the left sidebar, click Webhooks under the Integration section.
  2. Click Manage receive endpoints on the Webhook Receiver card.


The Webhooks page — click "Manage receive endpoints" on the Webhook Receiver card.

Creating a Webhook Endpoint

The creation wizard guides you through four steps: Name & Mode, Test Webhook, Map Fields, and Activate.

Step 1 — Name & Mode

  1. Enter a Name for your webhook endpoint (e.g. "Lead Gen Sync", "Form Submissions").
  2. Optionally add a Description to explain what this endpoint receives.
  3. Select the Object Type — choose whether incoming data should create Person, Company, or Deal records.
  4. Choose your Mapping Mode:
  • Smart (AI) — Best for most use cases. AI automatically analyzes the incoming JSON payload and extracts relevant fields. No manual configuration needed.
  • Manual Mapping — For full control. You manually map each payload field to a Breakcold record field. Best when you need precise, predictable mappings.


Step 1: Enter a name, choose the object type, and select Smart (AI) or Manual Mapping mode.
Example: Endpoint named with Object Type set to "Person" and mapping mode selected.

  1. Click Next to proceed to the test step.

Step 2 — Test Webhook

In this step, Breakcold generates your unique webhook URL and waits for a test payload.

  1. Copy the webhook URL shown on the page. This is the HTTPS URL you will paste into your external software.
  2. Go to your external tool and configure it to send a webhook to this URL. Alternatively, use the cURL command provided on the page to send a quick test from your terminal.
  3. Breakcold will show "Waiting for test payload..." until it receives data. Once a payload arrives, it will be displayed and you can proceed.


Copy the webhook URL and send a test payload — a cURL example is provided for quick testing.

Tip — You can use any tool that sends webhooks: form builders, automation platforms (Zapier, Make, n8n), lead generation tools, or even a simple cURL command from your terminal.

Step 3 — Map Fields (Smart AI Mode)

If you selected Smart (AI) mapping, Breakcold's AI automatically analyzes the incoming JSON payload and extracts the relevant fields.

  1. Once the test payload is received, the AI runs automatically and maps payload fields to Breakcold record fields (e.g. Email, Name, Notes).
  2. Review the mapping results in the table. Each row shows the Field name, Type, Extracted Value, and Status.

The AI automatically extracts and maps fields from the incoming payload.

  1. You can customize the AI behavior by entering AI Mapping Instructions at the top. For example, type "Only extract the email" or "Map company info to the Company Name field, ignore metadata fields".
  2. Click Re-run all to re-process the payload with your updated instructions.

Custom AI instructions let you control exactly which fields are extracted and how they are mapped.

Step 3 — Map Fields (Manual Mode)

If you selected Manual Mapping, you map each payload field to a Breakcold record field yourself.

  1. The table shows every field from the incoming JSON payload with its Payload Field name, Sample Value, and a Map to Field dropdown.
  2. For each payload field you want to import, click the Map to Field dropdown and select the corresponding Breakcold field (Email, Company Name, Phone, LinkedIn, Website, Location, Quick Notes, etc.).


Manual mapping: each payload field is listed with its sample value — select the matching Breakcold field.
The dropdown lists all available Breakcold fields — you can also create new custom attributes.

Note — You can also create new custom attributes directly from the dropdown by clicking + Create new attribute if none of the existing fields match your data.

Step 4 — Filter & Activate

Before activating, you can optionally set up an AI-powered filter to control which incoming webhooks create records.

  1. Toggle Enable AI condition to ON if you want to filter incoming data.
  2. Write your condition in natural language. For example:
  • "Only create if there's an email"
  • "Only if the business type is SaaS and the company has more than 50 employees"
  • "Only if the deal amount is greater than $1000"

Write filtering conditions in plain language — the AI evaluates each incoming webhook against your rule.

  1. Click Run preview to test your condition against the test payload and verify it works correctly.
  2. Click Configure & Activate to save and activate your webhook endpoint.
Warning — If you expect high volume or want to create a record for every webhook, leave the AI condition off. Filtering adds processing time and is best for selective imports.

Monitoring Your Webhook

Once active, you can monitor your webhook endpoint from its detail page.
The endpoint detail page shows your webhook URL, delivery stats (Total, Succeeded, Failed, Skipped), and a Delivery Logs tab.
The detail page includes:

  • Webhook URL — Your unique endpoint URL to share with external tools
  • Stats — Total requests, succeeded, failed, and skipped counts
  • Delivery Logs — A log of every incoming webhook with timestamp, status, and details
  • Settings — Edit the name, description, object type, mapping mode, and AI settings

Frequently Asked Questions

What software can I use with the Webhook Receiver?
Any software that can send HTTP POST requests with a JSON payload. This includes form builders, automation tools (Zapier, Make, n8n), lead generation platforms, CRM tools, custom scripts, and more.
What is the difference between Smart (AI) and Manual Mapping?
Smart (AI) mode automatically analyzes the incoming JSON and extracts relevant fields using AI — no configuration needed. Manual Mapping gives you full control by letting you map each payload field to a specific Breakcold field yourself.
Can I customize what the AI extracts?
Yes. In Smart (AI) mode, you can write custom AI Mapping Instructions in natural language (e.g. "Only extract the email" or "Ignore metadata fields") and re-run the mapping.
Can I filter which webhooks create records?
Yes. Enable the AI condition filter and write a natural language rule. For example, "Only create if there's an email" will skip any webhook that doesn't contain an email address.
What object types can I create from webhooks?
You can create Person, Company, or Deal records from incoming webhooks.
Can I create custom fields from the manual mapping?
Yes. When mapping fields manually, you can click "+ Create new attribute" in the dropdown to create a new custom field on the fly.
How do I test my webhook before going live?
In Step 2, Breakcold provides a cURL command you can run from your terminal to send a test payload. You can also send a test webhook from your external tool.
Where can I see delivery history?
On the webhook endpoint detail page, the Delivery Logs tab shows every incoming request with its timestamp, status (Succeeded/Failed/Skipped), and details.

Updated on: 03/04/2026