If you use an external tool (like Clay, Apollo, HubSpot, or Zapier) to manage your leads, you can push them directly into ReachBoost using the API or a native integration. This is the most automated way to keep your lead lists up to date.

Before you start

·        You need to be a Workspace Admin or Agency Admin to access API keys

·        Have your external tool open and ready to configure

·        Know which ReachBoost workspace, campaign, or lead list you want leads inserted into

Option A: Native HubSpot integration

If your leads live in HubSpot, you can connect HubSpot directly to ReachBoost without using the API. Note: the HubSpot integration is a one-way sync - ReachBoost pushes leads and activity data to HubSpot. It does not pull leads from HubSpot into ReachBoost.

1. Go to Integrations

In the left sidebar, click Integrations.

2. Click Connect next to HubSpot

Click the Connect button on the HubSpot card.

3. Authorise ReachBoost in HubSpot

You will be redirected to HubSpot to approve the connection. Log in if prompted and click Authorise.

4. Expected result

The HubSpot card now shows Connected. Lead activity from ReachBoost will sync to HubSpot automatically.

Option B: API key (for Zapier, Clay, Apollo, or custom setups)

1. Go to Integrations → API keys

In the left sidebar, click Integrations, then click the API keys tab.

2. Note your Workspace UUID

At the top of the page you will see your Workspace UUID. Copy this - you will need it when configuring your external tool.

3. Create a new API key

Click Add new API key, give it a name (e.g. "Clay integration"), and click Create.

4. Copy your API key

Your key will be shown once. Copy it immediately and store it somewhere safe - you cannot view it again after closing this screen.

5. Configure your external tool

Paste the API key and Workspace UUID into your external tool (Zapier, Clay, etc.) following that tool's setup instructions. Use ReachBoost's API to insert leads into the correct campaign.

Option C: Insert leads via API inside a campaign

When creating or editing a campaign, the Leads step allows you to select Insert leads via API as the source. This means the campaign will wait for leads to be pushed via the API rather than pulling from a static list.

1. In the campaign wizard, go to the Leads step

2. Select "Insert leads via API" from the dropdown

3. Launch the campaign

The campaign will remain in a ready state until leads are pushed to it via the API.

Option D: Push leads directly to a lead list

You can push leads directly into a lead list via the API without attaching them to a campaign. This is useful if you want to build or update a list first and decide on campaigns later.

Use the POST /leads endpoint with your API key and Workspace UUID, and specify the target lead_list_id instead of a campaign_id. The lead list will be created if it does not already exist.

If it didn't work - checklist

·        [ ] Is the API key correct? (copy-paste it rather than typing manually)

·        [ ] Is the Workspace UUID correct? (check Integrations → API keys)

·        [ ] Does the API key belong to the right workspace? (each workspace has its own keys)

·        [ ] Does the external tool have the correct endpoint URL?

·        [ ] Is the lead data including a valid linkedin_url field?

·        [ ] Is the campaign in Active status and ready to receive leads?

If none of the above resolves the issue, contact support with your Workspace UUID and a description of the error you are seeing.

Next step: Create a new connection campaign (link to article 07)

Updated on: 09/06/2026