---
title: "Move promoters to campaign"
method: POST
path: "/promoters/move_to_campaign"
tags: ["Promoters"]
---

# Move promoters to campaign

`POST /promoters/move_to_campaign`

With this endpoint you can move promoters from one campaign to another. 
 <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/move_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`
  - `from_campaign_id` integer, required — The ID of the campaign promoter will be moved from
  - `to_campaign_id` integer, required — The ID of the campaign promoter will be moved to
  - `drip_emails` boolean — If true, it will send an email to the promoter for this action
  - `soft_move_referrals` boolean — If `true`, move referrals to NEW campaign and future commissions from existing referrals will be tracked in the NEW campaign. However, if `false`, keep referrals in the old campaign and future commissions from existing referrals will be tracked in the OLD campaign.

## 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.net/firstpromoter/apis/firstpromoter-batch-processes-api.md) · [All operations](https://skmtc.net/firstpromoter/apis/firstpromoter-batch-processes-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/firstpromoter/firstpromoter-batch-processes-api/versions/e15f0d026ccf/schema)