---
title: "Add CRM records (up to 100 ids per call) to a campaign; returns how many were added and why others were skipped"
method: POST
path: "/campaigns/{sequenceId}/people"
tags: ["campaigns"]
---

# Add CRM records (up to 100 ids per call) to a campaign; returns how many were added and why others were skipped

`POST /campaigns/{sequenceId}/people`

## Request

- Base URL: `https://www.dench.com/api/v1`
- URL: `https://www.dench.com/api/v1/campaigns/{sequenceId}/people`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Add CRM records (up to 100 ids per call) to a campaign; returns how many were added and why others were skipped.

## Path parameters

- `sequenceId` string, required

## Request body

- object
  - `objectName` string, required: CRM object the ids belong to, e.g. lead or people.
  - `entryIds` string[], required
  - `emailFieldName` string: Column holding the email when it is not "Email".
  - `linkedinUrlFieldName` string: Column holding the LinkedIn profile URL.
  - `nameFieldName` string
  - `relationFieldName` string: Follow this relation to the person record first.
  - `relationDirection` 'reverse'
  - `checkDuplicatesAcrossWorkspace` boolean: Default true: skip people active in another campaign.

## Response `200`

Successful response

- object
  - `added` number, required
  - `requested` number, required
  - `cappedAtLimit` number, nullable, required: The campaign's people cap when it cut the batch short (300), else null.
  - `duplicates` number, required: Already in this campaign.
  - `merged` number, required: Duplicates that gained a missing email or LinkedIn URL.
  - `duplicatesElsewhere` number, required: Active in another campaign; skipped unless checkDuplicatesAcrossWorkspace is false.
  - `suppressed` number, required
  - `invalid` number, required
  - `skippedNoIdentity` number, required: No usable email or LinkedIn URL on the record.
  - `skippedSample` number, required
  - `skippedMissingInfo` number, required: Launched campaigns only: a merge token the steps use is empty for them.
  - `missingInfoSample` object
    - `displayName` string
    - `missingKeys` string[], required

## Other responses

- `400`: Invalid request
- `401`: Missing or invalid authentication
- `404`: Operation or resource not found
- `500`: Server error

---

[API](https://skmtc.dev/dench/apis/dench-api.md) - [All operations](https://skmtc.dev/dench/apis/dench-api/llms.txt) - [OpenAPI document](https://skmtc.dev/dench/apis/dench-api/revisions/4a145b38f19c?raw)