# Sequences API

> Time-based drips: ordered steps (delay, message, optional condition) sent to enrolled contacts on one account; contacts exit on reply or unsubscribe.

Base URL: `https://api.socialit.com/v1`. Authenticate with `Authorization: Bearer <API key or OAuth token>`.

## List sequences

`GET /sequences`

Access: `read` · MCP tool: `list-sequences` · Zernio: `GET /v1/sequences`

### Query parameters

- `page` (integer; ≥ 1): Page number
- `limit` (integer; 1–100): Items per page (max 100)
- `sort` (string; one of created_at, name)
- `order` (string; one of asc, desc)
- `match` (string; one of all, or): Combine filters with AND (default) or OR
- `profile_id` (string)
- `account_id` (string)
- `status` (string)
- `platform` (string)

```bash
curl "https://api.socialit.com/v1/sequences" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "object": "sequence",
      "id": "string",
      "profile_id": "string",
      "account_id": "string",
      "account_name": "string",
      "platform": "string",
      "name": "string",
      "description": "string",
      "status": "draft",
      "steps": [
        {
          "order": 1,
          "delay_minutes": 1,
          "message": {
            "text": null,
            "attachments": [],
            "message_tag": null
          },
          "condition": {
            "variable": null,
            "operator": null,
            "value": null,
            "on_false": null
          }
        }
      ],
      "steps_count": 1,
      "message_preview": "string",
      "exit_on_reply": true,
      "exit_on_unsubscribe": true,
      "stats": {
        "total_enrolled": 1,
        "active": 1,
        "paused": 1,
        "completed": 1,
        "exited": 1
      },
      "created_at": "2026-10-13T09:00:00.000Z",
      "updated_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "page": 1,
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Create a sequence

`POST /sequences`

Access: `write` · MCP tool: `create-sequence` · Zernio: `POST /v1/sequences`

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `profile_id` (string)
- `account_id` (string; required)
- `platform` (string; one of instagram, facebook, x, bluesky, reddit, discord, mastodon, tiktok, twitter)
- `name` (string; required; 1–200 characters)
- `description` (string | null; ≤ 2000 characters)
- `steps` (array of object; ≤ 50 items)
  - `steps[].order` (integer; required; 1–1000)
  - `steps[].delay_minutes` (integer; required; 0–525600)
  - `steps[].message` (object | null)
    - `steps[].message.text` (string | null; ≤ 4096 characters)
    - `steps[].message.attachments` (array of object; ≤ 10 items)
      - `steps[].message.attachments[].type` (string; one of image, video, audio, file)
      - `steps[].message.attachments[].url` (string; required; 1–2048 characters)
      - `steps[].message.attachments[].filename` (string; ≤ 255 characters)
    - `steps[].message.message_tag` (string | null; one of HUMAN_AGENT, CONFIRMED_EVENT_UPDATE, POST_PURCHASE_UPDATE, ACCOUNT_UPDATE)
  - `steps[].condition` (object | null)
    - `steps[].condition.variable` (string; required; 1–200 characters)
    - `steps[].condition.operator` (string; required)
    - `steps[].condition.value` (any)
    - `steps[].condition.on_false` (string; one of skip, exit)
- `exit_on_reply` (boolean)
- `exit_on_unsubscribe` (boolean)

```bash
curl -X POST "https://api.socialit.com/v1/sequences" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "profile_id": "string",
    "account_id": "string",
    "platform": "instagram",
    "name": "string",
    "description": "string"
  }'
```

Response 201:

```json
{
  "object": "sequence",
  "id": "string",
  "profile_id": "string",
  "account_id": "string",
  "account_name": "string",
  "platform": "string",
  "name": "string",
  "description": "string",
  "status": "draft",
  "steps": [
    {
      "order": 1,
      "delay_minutes": 1,
      "message": {
        "text": "string",
        "attachments": [
          {
            "type": null,
            "url": null,
            "filename": null
          }
        ],
        "message_tag": "string"
      },
      "condition": {
        "variable": "string",
        "operator": "string",
        "value": null,
        "on_false": "string"
      }
    }
  ],
  "steps_count": 1,
  "message_preview": "string",
  "exit_on_reply": true,
  "exit_on_unsubscribe": true,
  "stats": {
    "total_enrolled": 1,
    "active": 1,
    "paused": 1,
    "completed": 1,
    "exited": 1
  },
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## Get a sequence

`GET /sequences/{id}`

Access: `read` · MCP tool: `get-sequence` · Zernio: `GET /v1/sequences/{sequenceId}`

### Path parameters

- `id` (string; required; 1–80 characters): sequence id (seq_…)

```bash
curl "https://api.socialit.com/v1/sequences/seq_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "sequence",
  "id": "string",
  "profile_id": "string",
  "account_id": "string",
  "account_name": "string",
  "platform": "string",
  "name": "string",
  "description": "string",
  "status": "draft",
  "steps": [
    {
      "order": 1,
      "delay_minutes": 1,
      "message": {
        "text": "string",
        "attachments": [
          {
            "type": null,
            "url": null,
            "filename": null
          }
        ],
        "message_tag": "string"
      },
      "condition": {
        "variable": "string",
        "operator": "string",
        "value": null,
        "on_false": "string"
      }
    }
  ],
  "steps_count": 1,
  "message_preview": "string",
  "exit_on_reply": true,
  "exit_on_unsubscribe": true,
  "stats": {
    "total_enrolled": 1,
    "active": 1,
    "paused": 1,
    "completed": 1,
    "exited": 1
  },
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## Update a sequence

`PATCH /sequences/{id}`

steps can only be replaced while draft or paused (409 sequence_not_editable).

Access: `write` · MCP tool: `update-sequence` · Zernio: `PATCH /v1/sequences/{sequenceId}`

### Path parameters

- `id` (string; required; 1–80 characters): sequence id (seq_…)

### Body

- `name` (string; 1–200 characters)
- `description` (string | null; ≤ 2000 characters)
- `steps` (array of object; ≤ 50 items)
  - `steps[].order` (integer; required; 1–1000)
  - `steps[].delay_minutes` (integer; required; 0–525600)
  - `steps[].message` (object | null)
    - `steps[].message.text` (string | null; ≤ 4096 characters)
    - `steps[].message.attachments` (array of object; ≤ 10 items)
      - `steps[].message.attachments[].type` (string; one of image, video, audio, file)
      - `steps[].message.attachments[].url` (string; required; 1–2048 characters)
      - `steps[].message.attachments[].filename` (string; ≤ 255 characters)
    - `steps[].message.message_tag` (string | null; one of HUMAN_AGENT, CONFIRMED_EVENT_UPDATE, POST_PURCHASE_UPDATE, ACCOUNT_UPDATE)
  - `steps[].condition` (object | null)
    - `steps[].condition.variable` (string; required; 1–200 characters)
    - `steps[].condition.operator` (string; required)
    - `steps[].condition.value` (any)
    - `steps[].condition.on_false` (string; one of skip, exit)
- `exit_on_reply` (boolean)
- `exit_on_unsubscribe` (boolean)

```bash
curl -X PATCH "https://api.socialit.com/v1/sequences/seq_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "description": "string",
    "steps": [
      {
        "order": 1,
        "delay_minutes": 0
      }
    ],
    "exit_on_reply": true,
    "exit_on_unsubscribe": true
  }'
```

Response 200:

```json
{
  "object": "sequence",
  "id": "string",
  "profile_id": "string",
  "account_id": "string",
  "account_name": "string",
  "platform": "string",
  "name": "string",
  "description": "string",
  "status": "draft",
  "steps": [
    {
      "order": 1,
      "delay_minutes": 1,
      "message": {
        "text": "string",
        "attachments": [
          {
            "type": null,
            "url": null,
            "filename": null
          }
        ],
        "message_tag": "string"
      },
      "condition": {
        "variable": "string",
        "operator": "string",
        "value": null,
        "on_false": "string"
      }
    }
  ],
  "steps_count": 1,
  "message_preview": "string",
  "exit_on_reply": true,
  "exit_on_unsubscribe": true,
  "stats": {
    "total_enrolled": 1,
    "active": 1,
    "paused": 1,
    "completed": 1,
    "exited": 1
  },
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## Delete a sequence

`DELETE /sequences/{id}`

Live enrollments exit with sequence_deleted.

Access: `write` · MCP tool: `delete-sequence` · Zernio: `DELETE /v1/sequences/{sequenceId}`

### Path parameters

- `id` (string; required; 1–80 characters): sequence id (seq_…)

```bash
curl -X DELETE "https://api.socialit.com/v1/sequences/seq_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "sequence",
  "id": "string",
  "deleted": true
}
```

## Activate a sequence

`POST /sequences/{id}/activate`

Paused enrollments resume (overdue steps are sent now).

Access: `write` · MCP tool: `activate-sequence` · Zernio: `POST /v1/sequences/{sequenceId}/activate`

### Path parameters

- `id` (string; required; 1–80 characters): sequence id (seq_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/sequences/seq_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/activate" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"
```

Response 200:

```json
{
  "object": "sequence",
  "id": "string",
  "profile_id": "string",
  "account_id": "string",
  "account_name": "string",
  "platform": "string",
  "name": "string",
  "description": "string",
  "status": "draft",
  "steps": [
    {
      "order": 1,
      "delay_minutes": 1,
      "message": {
        "text": "string",
        "attachments": [
          {
            "type": null,
            "url": null,
            "filename": null
          }
        ],
        "message_tag": "string"
      },
      "condition": {
        "variable": "string",
        "operator": "string",
        "value": null,
        "on_false": "string"
      }
    }
  ],
  "steps_count": 1,
  "message_preview": "string",
  "exit_on_reply": true,
  "exit_on_unsubscribe": true,
  "stats": {
    "total_enrolled": 1,
    "active": 1,
    "paused": 1,
    "completed": 1,
    "exited": 1
  },
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## Pause a sequence

`POST /sequences/{id}/pause`

Access: `write` · MCP tool: `pause-sequence` · Zernio: `POST /v1/sequences/{sequenceId}/pause`

### Path parameters

- `id` (string; required; 1–80 characters): sequence id (seq_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

```bash
curl -X POST "https://api.socialit.com/v1/sequences/seq_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pause" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"
```

Response 200:

```json
{
  "object": "sequence",
  "id": "string",
  "profile_id": "string",
  "account_id": "string",
  "account_name": "string",
  "platform": "string",
  "name": "string",
  "description": "string",
  "status": "draft",
  "steps": [
    {
      "order": 1,
      "delay_minutes": 1,
      "message": {
        "text": "string",
        "attachments": [
          {
            "type": null,
            "url": null,
            "filename": null
          }
        ],
        "message_tag": "string"
      },
      "condition": {
        "variable": "string",
        "operator": "string",
        "value": null,
        "on_false": "string"
      }
    }
  ],
  "steps_count": 1,
  "message_preview": "string",
  "exit_on_reply": true,
  "exit_on_unsubscribe": true,
  "stats": {
    "total_enrolled": 1,
    "active": 1,
    "paused": 1,
    "completed": 1,
    "exited": 1
  },
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## Enroll contacts in a sequence

`POST /sequences/{id}/enroll`

The channel is the contact's subscribed channel on the sequence account unless channel_ids pin one. Already-enrolled contacts are skipped.

Access: `write` · MCP tool: `enroll-sequence-contacts` · Zernio: `POST /v1/sequences/{sequenceId}/enroll`

### Path parameters

- `id` (string; required; 1–80 characters): sequence id (seq_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `contact_ids` (array of string; required; 1–1000 items)
- `channel_ids` (array of string; ≤ 1000 items)

```bash
curl -X POST "https://api.socialit.com/v1/sequences/seq_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/enroll" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "contact_ids": [
      "string"
    ],
    "channel_ids": [
      "string"
    ]
  }'
```

Response 200:

```json
{
  "object": "sequence_enroll_result",
  "enrolled": 1,
  "skipped": 1,
  "failed": 1,
  "results": [
    {
      "contact_id": "string",
      "success": true,
      "enrollment_id": "string",
      "error": "string"
    }
  ]
}
```

## Unenroll a contact

`DELETE /sequences/{id}/enroll/{contactId}`

Access: `write` · MCP tool: `unenroll-sequence-contact` · Zernio: `DELETE /v1/sequences/{sequenceId}/enroll/{contactId}`

### Path parameters

- `id` (string; required; 1–80 characters): sequence id (seq_…)
- `contactId` (string; required; 1–80 characters): contact id (con_…)

```bash
curl -X DELETE "https://api.socialit.com/v1/sequences/seq_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/enroll/con_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "sequence_enrollment",
  "id": "string",
  "sequence_id": "string",
  "contact_id": "string",
  "channel_id": "string",
  "contact_name": "string",
  "platform_identifier": "string",
  "status": "active",
  "exit_reason": "string",
  "current_step_index": 1,
  "steps_sent": 1,
  "next_step_at": "2026-10-13T09:00:00.000Z",
  "last_step_sent_at": "2026-10-13T09:00:00.000Z",
  "last_error": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "updated_at": "2026-10-13T09:00:00.000Z"
}
```

## List sequence enrollments

`GET /sequences/{id}/enrollments`

Access: `read` · MCP tool: `list-sequence-enrollments` · Zernio: `GET /v1/sequences/{sequenceId}/enrollments`

### Path parameters

- `id` (string; required; 1–80 characters): sequence id (seq_…)

### Query parameters

- `page` (integer; ≥ 1): Page number
- `limit` (integer; 1–100): Items per page (max 100)
- `sort` (string; one of created_at, next_step_at)
- `order` (string; one of asc, desc)
- `match` (string; one of all, or): Combine filters with AND (default) or OR
- `status` (string)
- `contact_id` (string)

```bash
curl "https://api.socialit.com/v1/sequences/seq_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/enrollments" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "object": "sequence_enrollment",
      "id": "string",
      "sequence_id": "string",
      "contact_id": "string",
      "channel_id": "string",
      "contact_name": "string",
      "platform_identifier": "string",
      "status": "active",
      "exit_reason": "string",
      "current_step_index": 1,
      "steps_sent": 1,
      "next_step_at": "2026-10-13T09:00:00.000Z",
      "last_step_sent_at": "2026-10-13T09:00:00.000Z",
      "last_error": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "updated_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "page": 1,
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```


---

Source: https://socialit.com/docs/api-reference/sequences/
