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

# Introduction

> Leadhub connects publishers with financial advertisers in real time.

## What is Leadhub?

Leadhub is a lead distribution platform for the financial sector. Publishers submit customer applications and Leadhub distributes them in real time to matching advertisers.

<CardGroup cols={2}>
  <Card title="Publisher API" icon="paper-plane" href="/api-reference/publisher/submit-lead">
    Submit customer leads and receive an immediate response with the lead status.
  </Card>

  <Card title="Advertiser API" icon="webhook" href="/api-reference/advertiser/update-lead-status">
    Notify Leadhub when a lead converts so publishers get credited.
  </Card>
</CardGroup>

## How it works

<Steps>
  <Step title="Publisher submits a lead">
    Send a `POST /lead` with the customer's data, product details and consents.
  </Step>

  <Step title="Leadhub distributes the lead">
    Leadhub validates eligibility, checks for duplicates and matches the lead against active advertisers in real time.
  </Step>

  <Step title="Publisher receives the response">
    The response is synchronous — `new` if accepted but no advertiser match was found yet, `distributed` with a `redirect_url` to send the customer to, or `rejected` with a reason.
  </Step>

  <Step title="Advertiser notifies a conversion">
    When the customer converts, the advertiser calls `PATCH /lead/{lead_id}/status`. Leadhub forwards the event to the publisher's configured callback URL.
  </Step>
</Steps>

## Key concepts

| Term              | Description                                                                                                               |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------- |
| **Publisher**     | Affiliate or traffic source that submits leads                                                                            |
| **Advertiser**    | Financial institution that receives and processes leads                                                                   |
| **Lead**          | A customer application submitted by a publisher                                                                           |
| **lead\_id**      | Unique identifier assigned by Leadhub at submission time. Used to link advertiser events back to the original submission. |
| **redirect\_url** | URL to redirect the customer to when a lead is accepted                                                                   |