Back to catalog

Instantly · Outreach

API Explorer / Create lead

Requires one of the following scopes: leads:create, leads:all, all:create, all:all Not enforced by Instantly's own schema as required, but in practice campaign and email are needed to create a usable lead.

Private Gateway connection

Data below comes from the configured private Gateway. Provider activation remains governed by its evidence and policy gates.

unverifiedRequest shape unavailableUnverified
Published API evidence
Public metadata only. Response bodies, credentials, and internal review notes are never displayed.

No verification date is claimed. No response capture is claimed.

Request parameters

  • assigned_to body · optional

    ID of the user assigned to the lead. Example: "01a0abd0-46e2-7acf-aedc-3e5f392e083f"

  • blocklist_id body · optional

    The ID of the blocklist to check for the lead. Example: "01a0abd0-9ab4-77df-bb73-db7a878eab21"

  • campaign body · optional

    Campaign ID associated with the lead. Example: "01a0abd0-46e2-7acf-aedc-3e58827a8d11"

  • company_name body · optional

    Company name of the lead. Example: "Example Inc."

  • custom_variables body · optional

    Custom variables can include any metadata about the lead that is relevant to the campaign, the campaign will be updated to allow all the other leads in the campaign to have the same custom variables. The custom variables will be added to the lead payload field

  • email body · optional

    Email address of the lead. Example: "example@example.com"

  • first_name body · optional

    First name of the lead. Example: "John"

  • job_title body · optional

    Job title of the lead. Example: "Head of Growth"

  • last_name body · optional

    Last name of the lead. Example: "Doe"

  • list_id body · optional

    List ID associated with the lead. Example: "01a0abd0-46e2-7acf-aedc-3e5dd99520f7"

  • lt_interest_status body · optional

    Lead interest status. It can be either a static value (check below), or a custom status interest value. Example: 1

  • personalization body · optional

    Personalization of the lead. Example: "Hello, how are you?"

  • phone body · optional

    Phone number of the lead. Example: "+1234567890"

  • pl_value_lead body · optional

    Potential value of the lead. Example: "High"

  • skip_if_in_campaign body · optional

    Whether to skip if the lead is already in the campaign. Example: true

  • skip_if_in_list body · optional

    Whether to skip if the lead is already in the list. Example: true

  • skip_if_in_workspace body · optional

    Whether to skip if the lead is already in the workspace. Example: true

  • verify_leads_for_lead_finder body · optional

    Whether to verify the leads for the lead finder. Example: true

  • verify_leads_on_import body · optional

    Whether to verify the leads on import. Example: true

  • website body · optional

    Website of the lead. Example: "https://example.com"

Sign in to run this operation, inspect live eligibility, and see governed execution and audit evidence. Sign in.

API Explorer / Create lead · looot