---
title: "Initiate a new bulk sequence subscription"
method: POST
path: "/bulk_action/sequence_subscription/"
tags: ["bulk_actions.sequence_subscriptions"]
---

# Initiate a new bulk sequence subscription

`POST /bulk_action/sequence_subscription/`

`action_type` must be one of:

- `subscribe` to create a new sequence subscription for contacts that have never received the given sequence.
- `resume` to resume any paused sequence subscriptions for the given sequence or all sequences if `sequence_id` is not provided.
- `resume_finished` to resume any finished sequence subscriptions for the given sequence or all sequences if `sequence_id` is not provided.
- `pause` to pause any active sequence subscriptions for the given sequence or all sequences if `sequence_id` is not provided.

`sequence_id`, `sender_account_id`, `sender_name`, `sender_email` and `contact_preference` are required if `action_type` is `subscribe`.

`contact_preference` can be set to:

- `lead` to only subscribe the primary/first contact email of the lead.
- `contact` to subscribe the primary email of each contact of the lead.

## Response `200`

Successful response

- BulkSequenceSubscriptionAction
  - `action_type` 'subscribe' | 'resume' | 'resume_finished' | 'pause' | 'reassign', required
  - `calls_assigned_to` string[], nullable, required
  - `contact_preference` 'lead' | 'contact', required
  - `created_by` string, nullable, required
  - `date_created` string, date-time, nullable, required
  - `date_updated` string, date-time, nullable, required
  - `from_phone_number_id` string, nullable, required
  - `id` string, required
  - `n_leads` integer, nullable, required
  - `n_leads_processed` integer, required
  - `n_objects` integer, nullable, required
  - `n_objects_processed` integer, required
  - `organization_id` string, required
  - `query` string, nullable, required
  - `results_limit` integer, nullable, required
  - `s_query` object, required
  - `send_done_email` boolean, required
  - `sender_account_id` string, nullable, required
  - `sender_email` string, nullable, required
  - `sender_name` string, nullable, required
  - `sequence_id` string, nullable, required
  - `sort` object[], required
  - `status` 'created' | 'loading' | 'processing' | 'done' | 'paused' | 'resuming' | 'error', required
  - `updated_by` string, nullable, required

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Not found

---

[API](https://skmtc.net/close/apis/close-api.md) · [All operations](https://skmtc.net/close/apis/close-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/close/close-api/revisions/0dcf3303e9d7/schema)