Skip to main content

How to Add Prospects via Webhook URL

Use a Webhook to automatically add new prospects to your campaign from any external tool

Written by Sharon Drelevich
Updated over a week ago
  1. Go to campaigns and select create campaign


  2. Select the source " Webhook"


  3. Click on “Generaste a public URL" under the Webhook URL:


  4. Then click on the button to copie unique Webhook URL where you'll send the data.


  5. Send a POST Request to the URL

    You can send data to the campaign by making a POST request to the copied URL.


  6. Optional: Add an authentication token

    Click on "Generate Auth Token"

    b. Add your API authentication token to the header using the key.


  7. Body Request

Required Fields

Each prospect must include either:

a. At least one contact method: ​email, linkedinUrl, or phoneNumber


OR

b. A full identity: ​firstName, lastName, and company


Option A: Submit Prospect Fields

In the body of the request, include the prospect’s information as key-value pairs, like this:


  • Optional Fields

    • firstName

    • lastName

    • middleName

    • jobTitle

    • headline

    • linkedinProfileId

    • linkedinUrl

    • photoUrl

    • phoneNumber

    • state

    • city

    • country

    • company

    • email

    • seniority

    • description

    • companySummary

    • companyWebsite

    • companyCity

    • companyState

    • companyCountry

    • companyLogoUrl

    • companyLinkedinUrl

    • extraInfo1

    • extraInfo2

    • extraInfo3

    • extraInfoData - Object {columName: columnValue}. For example: {"Source" : "Linkedin", "Sourced At": "2026-08-10 11:08"}.

    Option B: Column Mapping

Use a template to prefill the column mapping, or leave it empty to start without any mapping.

Click on "Select Template." If you are not running a webhook campaign directly from RB2B, select the "Start from scratch" option. After that, begin mapping the incoming webhook body to the relevant Alta columns.


Did this answer your question?