Lead Ingestion API

The technical bridge between your traffic sources and the PULSE engine.

Overview

Every lead starts with a POST request. Whether it's a WordPress site, a custom React form, or a Webflow landing page, the process is the same.

Ingestion Flow

{
[User] -> (Landing Page Form)
                |
                v
        (Backend / API Proxy)
                |
                v
      [POST /api/leads/submit]
                |
      +-------------------+
      | 1. Auth Check     |
      | 2. Spam Check     |
      | 3. Campaign Match |
      +-------------------+
                |
                v
        [Distribution Engine]
}

Implementation Details

Endpoint

URL: https://admin.pulse.bpcorp.eu/api/leads/submit Method: POST

Authentication

You must provide the Vertical API Key in the headers. X-Source-API-Key: YOUR_VERTICAL_KEY

Smart Mapping

The engine uses the utm_source or channel field in your JSON to find the right campaign. channel: "seo" -> Looks for "Vertical Name - SEO" channel: "meta" -> Looks for "Vertical Name - Meta"

Auto-Creation

If the campaign doesn't exist yet (e.g., you launch a new "TikTok" channel), the API will create it automatically on the fly. You just need to set its price later in the Admin panel.

Lead Ingestion API

The technical bridge between your traffic sources and the PULSE engine.

Overview

Every lead starts with a POST request. Whether it's a WordPress site, a custom React form, or a Webflow landing page, the process is the same.

Ingestion Flow

{
[User] -> (Landing Page Form)
                |
                v
        (Backend / API Proxy)
                |
                v
      [POST /api/leads/submit]
                |
      +-------------------+
      | 1. Auth Check     |
      | 2. Spam Check     |
      | 3. Campaign Match |
      +-------------------+
                |
                v
        [Distribution Engine]
}

Implementation Details

Endpoint

URL: https://admin.pulse.bpcorp.eu/api/leads/submit Method: POST

Authentication

You must provide the Vertical API Key in the headers. X-Source-API-Key: YOUR_VERTICAL_KEY

Smart Mapping

Auto-Creation

If the campaign doesn't exist yet (e.g., you launch a new "TikTok" channel), the API will create it automatically on the fly. You just need to set its price later in the Admin panel.

Lead Ingestion (Technical)

Lead Ingestion API

Overview

Implementation Details

Endpoint

Authentication

Smart Mapping

Auto-Creation

Lead Ingestion (Technical)

Lead Ingestion API

Overview

Implementation Details

Endpoint

Authentication

Smart Mapping

Auto-Creation