latestOpenAPI 3.0.3AGPL-3.0 license2026-08-2011401.8 MB

a1e86af2406d

contacts

Create a lead-gen campaign

Create a campaign with optional agent context (markdown brief)..

post/contacts/campaigns

Request body

namestring required

Human-readable campaign name. Use a clear, descriptive title. Do NOT use slugs or technical IDs.

descriptionstring

Optional campaign description

languagestring

ISO 639-1 language code (e.g. 'fr', 'en'). Overrides ASCII heuristic for AI task language.

forceboolean

Bypass the duplicate-name guard. Normally the endpoint returns 409 with a suggested existing campaign when name is within Levenshtein 2 of one. Pass force: true after the agent has surfaced the suggestion to the user and they explicitly confirmed they want a second campaign with a similar name. Default: false.

draftMode'review'

Drafted messages wait for a human to approve them before they may send.

Response

Campaign created

successtrue required
creditsUsedinteger required

Credits consumed by this call. 0 for free endpoints, cached results, duplicates, and for every query that does not touch LinkedIn.

retryAfterinteger required

Seconds to wait before another call of the same type. 0 means no wait is needed.