Uploading leads

There are three ways to add leads to a NeuroPage campaign: CSV upload, manual entry, and webhook integration. All three result in the same outcome — leads are queued for personalized page generation.

CSV upload

CSV upload is the most common way to add leads in bulk. It works well for pre-generating pages before an outreach campaign launches, or when your lead source is a list export from a tool without a direct webhook integration.

How to upload

1. Open your campaign and click Add leads → Upload CSV
2. Drag and drop your CSV file, or click to browse for it
3. NeuroPage previews the first few rows and prompts you to map your columns to the standard lead fields
4. Review the mapping — column name matching is flexible, so firstname, first_name, and First Name are all recognized automatically
5. Click Import leads to start processing

Required and optional fields

At least one of linkedin_url or email must be present in each row. Rows missing both are skipped during import.

After upload

After clicking Import leads, you will see a preview of how many leads were found and a summary of any rows that were skipped (due to missing required fields or duplicate detection). Confirm to complete the import.

Leads are immediately queued for processing. Personalized pages are typically ready within 15–45 seconds per lead. You can monitor status in real time from the campaign's lead list.

Manual entry

Manual entry is for adding individual leads — for example, a high-priority prospect you want to add quickly without preparing a CSV.

1. Open your campaign and click Add leads → Add manually
2. Fill in the form:
   • LinkedIn URL (required, or email as alternative)
   • Email
   • First name
   • Last name
   • Company
   • Job title
3. Click Add lead

The lead is immediately queued for processing.

Webhook (Apollo, Amplemarket, Instantly)

If your campaign is connected to an outbound sequencing tool via webhook, leads flow in automatically whenever a contact enters the configured sequence step.

Getting your webhook credentials

1. Open your campaign and go to Settings → Lead source
2. Select your outbound tool (Apollo, Amplemarket, or Instantly)
3. Copy the Webhook URL and Webhook secret

Use these credentials to configure the integration in your tool. For step-by-step instructions, see Integrations.

What happens when a lead arrives via webhook

1. NeuroPage receives the lead data from the webhook payload
2. The lead is created (or deduplicated if already in the campaign)
3. The lead is queued for personalized page generation
4. Once the page is ready, NeuroPage sends the personalized URL back to the tool via its API

Lead status lifecycle

After a lead is added (by any method), it moves through the following statuses:

Failed leads can be retried from the lead detail page.

Custom variables

You can pass extra context per lead by adding custom variable columns to your CSV or custom fields to your webhook payload. These variables are injected into the copy generation step and allow for deeper personalization beyond the standard fields.

Defining custom variables

In your campaign wizard (Step 1 — Campaign details), scroll to the Custom variables section and define the variable names you want to use. For example:

pain_point
use_case
competitor

Using custom variables in a CSV

Add a column with the matching name to your CSV. For example, a CSV with pain_point and use_case columns:

Using custom variables in a webhook payload

Include the extra fields in the JSON body alongside the standard lead fields:

{
  "linkedin_url": "{{contact.linkedin_url}}",
  "email": "{{contact.email}}",
  "first_name": "{{contact.first_name}}",
  "pain_point": "slow onboarding process",
  "use_case": "enterprise sales prospecting"
}

Referencing custom variables

Once defined and populated, custom variables are available to the copy generation engine and can be referenced in your campaign context field using double curly brace syntax:

{{pain_point}}
{{use_case}}
{{competitor}}

Custom variables are particularly useful for passing context that cannot be inferred from a LinkedIn profile — for example, information gathered during a discovery call or from intent data tools.