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

# Lead sources

> Bring every lead into RevDesk, from third-party sites, your website, your CRM or your own systems.

A lead source is where your leads come from: Cars.com, your website form, HubSpot, an OEM portal. Connect each
one once. From then on every new lead lands in RevDesk, and the agent or salesperson you choose follows up.

Open **Channels › Lead sources** and click **Add a source**.

## Choose a source

| Source | Use it for |
| - | - |
| **Lead emails (ADF)** | Cars.com, AutoTrader, CarGurus, TrueCar, OEM lead portals and any provider that sends ADF lead emails. Appears when your workspace has inventory turned on. |
| **Website form** | A form RevDesk hosts. Share the link or add it to your site. |
| **HubSpot** | Contacts added to a list, every new contact, or contacts a HubSpot workflow sends. |
| **HighLevel** | Contacts a HighLevel workflow sends. |
| **Typeform** | Responses to one of your typeforms. |
| **Zapier** | Anything Zapier connects to, through a webhook step. |
| **Webhook** | Your developer posts leads to a URL. |

## Set it up

**1. Name it and pick a location**

Give the source a name you'll recognize and choose the store it belongs to, or **Workspace-wide**.

**2. Choose who works these leads**

Pick a running campaign to follow up, or **Save leads only** (they land in Deals and nobody reaches out).
If new-lead follow-up already covers that store, the source joins it automatically.

**3. Connect and send a test lead**

Copy the address or URL into the provider, then click **Send a test lead**. A test lead is real: the agent
may call or text the phone you enter, so use your own.

Each source shows its status: **Live**, **Ready**, **Blocked**, **Paused** or **Not set up**.

## Connect your ADF lead feed

Every ADF source gets its own email address, like `abc123@leads.revdesk.com`. Give it to each provider:

1. Copy the address from the source.
2. Ask your Cars.com, AutoTrader, CarGurus or OEM rep to add it as a lead recipient. Your CRM can stay on the
   list too.
3. Send a test lead from the provider and watch it arrive.

You can tag where a lead came from by adding a suffix, such as `abc123+cars.com@leads.revdesk.com`. Providers
that post ADF XML instead of emailing it use the source's ADF posting URL.

## Webhooks for developers

Post JSON, form data or multipart to the source's URL:

```bash theme={null}
curl -X POST "https://app.revdesk.com/api/webhooks/leads/$INTAKE_TOKEN" \
  -H "Authorization: Bearer $SOURCE_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"lead_id": "lead_123", "name": "Jane Smith", "phone": "+14155551234", "email": "jane@example.com"}'
```

* **The URL is a credential.** The token in it identifies the source. Keep it private. To add a check, send the
  source secret as a Bearer token, or sign the raw body with HMAC-SHA256 keyed by the secret and send the hex
  digest in `X-RevDesk-Signature` (a `sha256=` prefix is fine).
* **Fields.** RevDesk reads common names on its own: `name`, `first_name`/`last_name`, `phone`, `mobile`,
  `email`, `message`, `comments`, `lead_id`, `external_id`, `source`. For other shapes, set dot paths such as
  `contact.mobile` under **Custom field names**. Send phone numbers in E.164, like `+14155551234`.
* **Test without outreach.** Add `"_test": true` to check a payload. Nothing is sent to the customer.
* **Responses.** `200` accepted (the body reports the outcome), `400` bad or empty payload, `401` bad secret or
  signature, `403` source paused, `404` unknown token, `429` rate limited (retry after `Retry-After`).

## Pause or rotate

Admins can **Pause this address** to turn new leads away without losing history. **Rotate credentials**
issues a new token and secret, and the old ones stop working at once.

> [!WARNING]
>
> Rotating also changes the source's ADF email address and posting URL. Give providers the new address before
> you rotate, or their leads will stop arriving.

## Who can add sources

Owners and admins can add, pause and rotate sources. Members can add sources for the stores they can access.
The built-in Sales role can't add sources.

> [card] [Your team and lead routing](https://docs.revdesk.com/start/team-and-routing.md)
>
> Decide who gets each new lead.

> [card] [Campaigns](https://docs.revdesk.com/app/campaigns.md)
>
> Follow up on new leads automatically.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.