---
title: "Update Contact Status in a Sequence"
method: POST
path: "/emailer_campaigns/remove_or_stop_contact_ids"
tags: ["Sequences"]
---

# Update Contact Status in a Sequence

`POST /emailer_campaigns/remove_or_stop_contact_ids`

This endpoint doesn't consume Apollo credits. Learn more about [API pricing and credits](https://docs.apollo.io/docs/api-pricing).

<a href="https://knowledge.apollo.io/hc/en-us/articles/4409237165837-Sequences-Overview" target="_blank">Sequences</a> are outreach campaigns that sales teams use to reach out to contacts over a planned period of time.<br><br>Use the Update Contact Status in a Sequence endpoint to either mark contacts as having `finished` a sequence, or to remove them from a sequence entirely.<br><br>This endpoint requires a master API key. If you call the endpoint without a master key, you receive a `403` response. Check out <a href="https://docs.apollo.io/docs/create-api-key">Create an API Key</a> to learn how to create a master key.

## Query parameters

- `emailer_campaign_ids[]` string[], required
- `contact_ids[]` string[], required
- `mode` string, required

## Response `200`

200

- object
  - `entity_progress_job` object
    - `id` string
    - `user_id` string
    - `job_type` string
    - `entity_ids` string[]
    - `params` object
      - `sequence_ids` string[]
      - `mode` string
      - `stop_reason` unknown
      - `api_key` string
      - `access_token` unknown
    - `progress` integer
    - `batch_size` integer

## Other responses

- `401` — 401
- `403` — 403
- `429` — 429

---

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