Queue people into one sequence. Nothing is sent in this call: people enter the paced engine and are contacted later inside working hours and account limits.

Choose a method

• contacts: 1 to 500 people, each with any mix of linkedinUrl, email and xUsername. Needs a connected LinkedIn account only when LinkedIn people go into a sequence with LinkedIn steps.
• manual: 1 to 500 people with LinkedIn URLs. Always needs a connected LinkedIn account.
• csv: CSV text with a header row, at most 500 rows. Always needs a connected LinkedIn account.
• sales_navigator: a saved Sales Navigator list URL. Imports in the background; poll GET /leads/imports/{batchId}. Always needs a connected LinkedIn account.

How contacts routes people

• Each person is queued only for the channels the sequence has steps for: connect steps are the LinkedIn lane, email steps the email lane, X DM or engage steps the X lane.
• A person with no identity for any of the sequence's channels is counted in invalidSkipped and not added.
• People already known by LinkedIn profile, email or X handle are counted in duplicatesSkipped.
• X handles are at most 15 characters. An X-only person becomes sendable once their handle has been resolved to an X account, which happens automatically shortly after the add.
• No paid lookups and no Energy charged.

Approval and replay

• Your request is the approval: a draft sequence is approved and started as part of the add. A paused sequence takes the people and stays paused.
• requestId is optional. Reusing it with the same body replays the stored result (reused: true); reusing it with a different body is refused.
• expectedRevision is optional on contacts. When given it must equal the sequence's current revision.

Refusals (409, nothing added)

idempotency_conflict, sequence_not_active, sequence_not_ready, sequence_revision_conflict, linkedin_not_connected (partners: complete a hosted connect link first) and the lead_import_csv_* mapping refusals, which carry details.