---
title: "Add leads"
method: POST
path: "/sequences/{id}/leads"
tags: ["Sequences"]
---

# Add leads

`POST /sequences/{id}/leads`

Add leads

## Request body

- object
  - `leads` object[], required — Leads to be added to the sequence
    - `email` string, email
    - `linkedin_url` string, uri
    - `data` object — Additional lead data fields
    - `routing` object — Account routing options
      - `salesforce_account_id` string, nullable — Salesforce Account ID to use for account association. > **Notes** > - When provided, Amplemarket treats this as the authoritative account and uses it instead of domain-based account matching. > - If a matching contact already exists under another account, Amplemarket re-associates it to the provided Salesforce account using its standard CRM behavior. > - If omitted, null, or empty, Amplemarket falls back to the default account matching behavior.
    - `overrides` object
      - `ignore_recently_contacted` boolean — Whether we should override recently contacted checks
      - `ignore_exclusion_list` boolean — Whether we should override exclusion list
      - `ignore_duplicate_leads_in_other_draft_sequences` boolean — Whether we should allow leads present in other draft sequences
      - `ignore_duplicate_leads_in_other_active_sequences` boolean — Whether we should allow leads present in other active sequences
  - `settings` object
    - `leads_distribution` 'sequence_senders' | 'custom_mailboxes', nullable
    - `mailboxes` string[] — Mailboxes to choose from when distributing with custom_mailboxes

## Response `200`

Ok

- object
  - `total` integer — Total number of leads processed in the request.
  - `total_added_to_sequence` integer — Total number of leads successfully added to the sequence.
  - `duplicate_emails` string[]
  - `duplicate_linkedin_urls` string[]
  - `in_exclusion_list_and_skipped` object[] — List of leads skipped due to exclusion list.
    - `email` string
    - `linkedin_url` string
  - `recently_contacted_and_skipped` object[] — List of leads skipped because they were recently contacted.
    - `email` string
    - `linkedin_url` string
  - `already_in_sequence_and_skipped` object[] — List of leads skipped because they are already in this sequence.
    - `email` string
    - `linkedin_url` string
  - `in_other_draft_sequences_and_skipped` object[] — List of leads skipped because they are present in another draft sequence.
    - `email` string
    - `linkedin_url` string
  - `in_other_active_sequences_and_skipped` object[] — List of leads skipped because they are present in another live or paused sequence.
    - `email` string
    - `linkedin_url` string

## Other responses

- `400` — Bad request
- `422` — Unprocessable entity

---

[API](https://skmtc.dev/amplemarket/apis/amplemarket-api-v1-docs.md) · [All operations](https://skmtc.dev/amplemarket/apis/amplemarket-api-v1-docs/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/amplemarket/amplemarket-api-v1-docs/revisions/57f46eaa2dc9/schema)
