Skip to main content
POST
Enrich a campaign
Only API-created campaigns in draft can start enrichment. Calling this operation again while the campaign is already enriching returns its current state, which makes launch retries safe. The launch validates the account list before charging credits: IDs not found in DataLane’s warehouse and accounts not eligible for enrichment (closed or inactive) are skipped and counted under accounts.excluded.invalid. It also applies the campaign’s excludeEnrichedWithinDays setting: accounts enriched within that lookback window are skipped. Set it at creation or change it with the update operation while the campaign is still a draft. Once the launch evaluation lands, accounts.eligible reports the eligible count and accounts.excluded reports the exclusion breakdown. The enrich response can briefly predate that evaluation — poll the get operation to read the resolved counts. See Campaign lifecycle for polling and credit behavior.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

campaignId
string
required
Pattern: ^camp_[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{21}$

Response

Response for status 200

data
object
required
error
null
required