Pushing Leads To Instantly

Topa can automatically send LinkedIn leads from your signals into an Instantly.ai campaign. Once configured, every time a signal runs and captures new leads, Topa enriches them (if needed), applies your saved filter and Ai Messaging pitch (optional), and pushes matching leads into Instantly. Company posts and irrelevant posts are excluded by default.

Step 1: Connect your Instantly API key

Before you can push leads, add your Instantly API key to Topa.

Get your Instantly API key: Log in to Instantly, open Settings → Integrations, then click API Keys and copy your key.

1. Log in to Topa

2. In the sidebar, click API Key / Integrations

3. Scroll to the Instantly.ai section

4. Enter a friendly account name (for example: Main Instantly Account)

5. Paste your Instantly API key

6. Click Connect

You can add multiple Instantly accounts if you use more than one API key. Each account gets a friendly name so you can pick the right one when setting up a signal integration.

Step 2: Open Integrations on a signal

Instantly is configured per signal — each signal can push to its own Instantly campaign.

1. In the sidebar, click LinkedIn Signals

2. Find the signal you want to connect in the signals table

3. In the Actions column, click Integrations

The Integrations dialog opens. You will see options for Smartlead, Instantly, Webhook, Topa Campaign, and HeyReach.

Step 3: Choose Instantly and set delivery options

Click Instantly.ai — Send leads to an Instantly campaign. Topa walks you through Step 1 of the Instantly setup:

Apply a saved filter (optional)

Choose Yes if you only want leads matching a saved filter to be pushed. Select the filter from the dropdown. Choose No to push all eligible leads from the signal (still excluding company posts and irrelevant posts by default).

If you have not created a saved filter yet, go to LinkedIn Leads, set up your ICP filters, and click Save filter first.

Apply an Ai Messaging template (optional)

Choose Yes if you want Topa to generate personalised messaging for each lead before pushing. Select the pitch from the dropdown. Choose No to push leads without generating Ai messaging first.

Prewritten messages will be available to use in the Instantly campaign as custom variables (for example outreach message, voicemail script, and LinkedIn connection note).

If you have not created a pitch yet, go to LinkedIn Leads and add one under Ai Messaging Pitch first.

Enrichment options

Instantly needs an email address for each lead. Choose how Topa should enrich leads before pushing:

• Enrich Email — look up email addresses only

• Enrich Cell & Email — look up both cellphone and email

Topa waits for enrichment to complete before sending a lead to Instantly. Enrichment uses credits from your account.

Click Continue when you are done.

Step 4: Select your Instantly account and campaign

In Step 2 of the Instantly setup:

1. Select your Instantly API key from the dropdown (the friendly name you set in Step 1)

2. Select the Instantly campaign you want leads added to

3. Choose a Duplicate check option: None, Skip If In Workspace, Skip If In Campaign, or Skip If In List

4. Choose a Verify leads option: No Verification, Instantly Will Verify On Import, or Instantly Will Verify On Import With Lead Finder

Click Save Integration.

The Instantly card on the Integrations home screen will show an Active badge when the integration is saved.

Step 5: Test and push leads

Once the integration is active, you have two useful actions on the Instantly card:

• Push Test Lead — send a single test lead to Instantly to verify delivery is working

• Push Old Leads — re-queue all eligible existing leads from this signal into Instantly (useful if you set up the integration after leads were already captured)

Clicking Push Old Leads asks you to confirm before queuing.

When does this trigger?

Each time your signal runs and captures new leads, Topa automatically:

1. Excludes company posts and irrelevant posts

2. Applies your saved filter (if configured)

3. Enriches email and/or cellphone (if configured)

4. Generates Ai messaging from your pitch (if configured)

5. Pushes matching leads into your Instantly campaign

Leads are sent with profile details, company info, LinkedIn activity context, and any Ai-generated messaging as custom variables in Instantly.

What data is sent to Instantly?

Topa sends a POST request to https://api.instantly.ai/api/v2/leads for each lead. Empty fields are omitted from the payload. This is the lead data your team will see on each contact inside Instantly.

Lead fields (visible in Instantly)

Import settings (configured in Topa, not visible on the lead)

When saving the integration in Topa, you can also set Duplicate check and Verify leads. These are passed to Instantly's API as import flags — they control how Instantly handles the import (e.g. skip duplicates, verify email on import). They are not fields that appear on the lead record inside Instantly.

• Skip If In Workspace — tells Instantly to skip the lead if they already exist in your workspace

• Instantly Will Verify On Import — tells Instantly to verify the email when the lead is imported

custom_variables fields

Example Data Available In Instantly To Run Campaigns

Example: Commenter (lead_type: commented)

A person who commented on a post on a monitored profile or company page. Same as a liker, but includes comment_text.

custom_variables

Example: Poster (lead_type: posted)

A person who posted about your monitored keyword (Keyword Monitoring signal). Includes keyword and their own post_text. For posters, source_author_name / source_author_url point to the poster themselves (they are the author).

custom_variables

Example: Liker (lead_type: liked)

A person who liked a post on a monitored profile or company page.

custom_variables