Skip to main content
POST
Create a campaign
The request accepts between 1 and 5,000 account UUIDs. Duplicate UUIDs are stored once. If name is omitted, DataLane assigns one. Set excludeEnrichedWithinDays to a non-negative integer to skip accounts enriched within that lookback window when enrichment launches. Omit it or pass null to disable the recency exclusion. The setting can be changed with the update operation while the campaign is a draft. Creation does not consume credits or start enrichment. Pass the returned campaign ID to the enrich operation.

Authorizations

Authorization
string
header
required

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

Body

accountIds
string<uuid>[]
required

Account UUIDs to enrich. Duplicates are stored once.

Required array length: 1 - 5000 elements
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Example:
name
string

Display name. DataLane assigns one if omitted.

Required string length: 1 - 200
Example:

"July target accounts"

excludeEnrichedWithinDays
integer | null

Skip accounts enriched within this many days when enrichment launches. Omit or pass null to disable the exclusion.

Required range: 0 <= x <= 9007199254740991
Example:

30

Response

Response for status 200

data
object
required
error
null
required