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

# Import leads via API

> Push leads into a lead list or straight into a campaign from your own stack.

The ReachBoost API has two endpoints for adding leads. Both expect the workspace UUID in the URL and the lead details in the body.

| You want to… | Endpoint |
| - | - |
| Add a lead to a lead list | `POST /workspaces/{workspace_uuid}/lead-lists/{lead_list_uuid}/leads` |
| Add a lead straight to a campaign | `POST /workspaces/{workspace_uuid}/campaigns/{campaign_uuid}/leads` |

Each lead needs **either a LinkedIn profile URL or an email**, or both.

See the full request shape, auth, and response examples in the [API reference](https://docs.reachboost.io/api-reference/introduction.md).

## Where to find the UUIDs

* **Workspace UUID** — open any workspace, copy from the URL.
* **Lead list UUID** — open the lead list, copy from the URL.
* **Campaign UUID** — open the campaign, copy from the URL.

## Related

* [API reference](https://docs.reachboost.io/api-reference/introduction.md)
* [CLI overview](https://docs.reachboost.io/cli/overview.md)


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