---
title: "Add Subscriber To List"
method: POST
path: "/api/subscriber/{subscriberId}/list"
tags: ["Subscriber"]
---

# Add Subscriber To List

`POST /api/subscriber/{subscriberId}/list`

Add a subscriber to a list with the given subscriber ID and list ID.<br><br>*Rate limit*:<br>Limit: 150<br>TTL: 60s

**Scopes:**
`list:manage`
`subscriber:manage`

## Path parameters

- `subscriberId` string, required — Primary key that uniquely identifies the subscriber. Generated by Bespoke.

## Headers

- `revision` string, required

## Request body

- AddSubscriberToListDto
  - `data` AddSubscriberToListDataObject, required
    - `type` 'list' | 'subscriber', required
    - `listId` string, required — Primary key that uniquely identifies the list. Generated by Bespoke.

## Response `200`

Add Subscriber To List

- SubscriberList
  - `id` string, required
  - `listId` string, required
  - `subscriberId` string, required
  - `emailConcent` object, required
  - `createdAt` string, date-time, required

## Other responses

- `5XX`
- `4XX`

---

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