---
title: "Create subscription list"
method: POST
path: "/subscription_lists"
tags: ["subscription_lists"]
---

# Create subscription list

`POST /subscription_lists`

Creates a subscription list record

## Request body

- CreateSubscriptionListRequest
  - `name` string, required — Name of the subscription list (cannot be 'default')

## Response `200`

Subscription list created successfully

- SubscriptionListResponse
  - `data` SubscriptionListsResponseData
    - `id` string — Subscription list ID
    - `type` 'subscription_list' — Resource type
    - `attributes` SubscriptionListsResponseAttributes
      - `name` string — Name of the subscription list
      - `is_default` boolean — Whether this is the default subscription list
      - `subscriber_count` integer — Number of subscribers in this list
      - `form_id` string — Form ID for use with Paubox Secure Forms

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `422` — Unprocessable entity
- `500` — Internal server error

---

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