Skip to main content
POST
Add ABM Campaign Leads
Beta: this endpoint requires the ABM beta on your team. Without it, the call answers 403 with BETA_NOT_ENABLED.
Takes People Database ids, from a People Database search or a contact-sourcing run’s contacts[].leadId, and adds each person to the campaign as a lead.

Filed under the campaign’s company

Each new contact is filed under the company the ABM campaign engages, whatever the person’s profile lists as their current employer. That keeps every lead of an ABM campaign on its account. Someone your workspace already has as a contact of another company is skipped and left where they are: the response lists them in skipped.

Authorizations

Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Path Parameters

campaignId
string
required

The ABM campaign, opened with Engage on a company

Body

application/json
leadIds
string[]
required

People Database ids, from People Database search results or a contact-sourcing run's contacts[].leadId.

Required array length: 1 - 199 elements

Response

What the call did. A skipped person is a normal outcome, not an error.