---
title: "Add promoters to campaign"
method: POST
path: "/promoters/add_to_campaign"
tags: ["Promoters"]
---

# Add promoters to campaign

`POST /promoters/add_to_campaign`

## Request

- Base URL: `https://api.firstpromoter.com/api/v2/company`
- URL: `https://api.firstpromoter.com/api/v2/company/promoters/add_to_campaign`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/firstpromoter/apis/firstpromoter-batch-processes-api/docs/promoters/add_to_campaign/post.ts> (a function with typed inputs; its response is checked against the schema)

With this endpoint you can add promoters to a campaign. 
 <Note>If there are more than __5__ ids on the __ids__ param/field, the action will be processed asynchronously. The response for the batch status will most likely be `in_progress`. The available statuses are `pending`, `in_progress`, `completed`, `failed` and `stopped`</Note> 
 <Tip>**HTTP Request** <br/>`POST https://api.firstpromoter.com/api/v2/company/promoters/add_to_campaign`</Tip>

## Headers

- `Account-ID` string, required

## Request body

- object
  - `ids` integer[]: Array of promoter ids. If there are more than __5__ ids on this param/field, the action will be processed asynchronously. The response for the batch status will most likely be `in_progress`. The available statuses are `pending`, `in_progress`, `completed`, `failed` and `stopped`
  - `campaign_id` integer, required: The ID of the campaign promoter will be added to
  - `drip_emails` boolean: If true, it will send an email to the promoter for this action

## Response `200`

Operation completed successfully

- object
  - `id` integer: Id of the batch operation
  - `status` 'completed': Status of the batch operation (always completed for synchronous operations)
  - `total` integer: Total number of items
  - `selected_total` integer: Number of selected items
  - `processed_count` integer: Number of processed items
  - `failed_count` integer: Number of failed operations
  - `action_label` string: Action identifier/ label assigned to the action
  - `created_at` string, date-time: Date and time when the batch operation was created
  - `updated_at` string, date-time: Date and time when the batch operation was updated
  - `meta` object: Meta data of the batch operation
  - `progress` integer: Progress of the action (0-100)
  - `processing_errors` string[]

## Other responses

- `202`: Batch operation accepted and processing
- `401`: Unauthorized
- `403`: Forbidden
- `422`: Invalid parameters

---

[API](https://skmtc.dev/firstpromoter/apis/firstpromoter-batch-processes-api.md) - [All operations](https://skmtc.dev/firstpromoter/apis/firstpromoter-batch-processes-api/llms.txt) - [OpenAPI document](https://skmtc.dev/firstpromoter/apis/firstpromoter-batch-processes-api/revisions/e15f0d026ccf?raw)