---
title: "Create Subscriber"
method: POST
path: "/api/subscriber"
tags: ["Subscriber"]
---

# Create Subscriber

`POST /api/subscriber`

Create a new Subscriber. Default email status is `SUBSCRIBED` to all list.<br><br>*Rate limit*:<br>Limit: 700<br>TTL: 60s

**Scopes:**
`subscriber:manage`

## Headers

- `revision` string, required

## Request body

- CreateSubscriberDto
  - `data` CreateSubscriberDataObject, required
    - `type` 'list' | 'subscriber', required
    - `attributes` CreateSubscriberAttributesObject, required
      - `email` string, required — Individuals email address
      - `firstName` string — Individuals first name
      - `lastName` string — Individuals last name
      - `phoneNumber` string — Individual's phone number in E.164 format
      - `location` CreateSubscriberLocationObject
        - `address1` string, required — First line of street address
        - `address2` string — Second line of street address
        - `city` string, required — City name
        - `country` string, required — Country Code
        - `state` string — State Code
        - `zipCode` string, required — Zip Code

## Response `200`

Create New Subscriber

- Subscriber
  - `id` string, required
  - `firstName` object, required
  - `lastName` object, required
  - `phoneNumber` object, required
  - `emailStatus` string, required
  - `updatedEmailStatusAt` string, date-time, nullable, required
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required
  - `subscriberAddress` object, 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)