---
title: "Create Mailing List"
method: POST
path: "/mailing-lists/"
tags: ["Mailing Lists"]
---

# Create Mailing List

`POST /mailing-lists/`

## Request

- Base URL: `https://api.thanks.io/api/v2`
- URL: `https://api.thanks.io/api/v2/mailing-lists/`
- Auth: HTTP bearer

If qrcode_url is provided, it will be used as the default QR Code URL when placing orders with this mailing list.

## Request body

- object
  - `description` string, required
  - `sub_account_id` integer: ID of the sub-account to associate with this mailing list. If not provided, the mailing list will be associated with the main account.
  - `qrcode_url` string: QR Code URL for the mailing list.

## Response `201`

Created

- object
  - `type` 'csv' | 'manual' | 'map' | 'friends' | 'retarget' | 'zapier' | 'radius' | 'highlevel' | 'qrscans'
  - `description` string
  - `sub_account_id` integer, nullable
  - `user_id` integer
  - `updated_at` string
  - `created_at` string
  - `id` integer

## Other responses

- `403`: Access token is missing or invalid

## Changes

- **2026-10-13** `f359343a6e41`: 1 info
  - removed the `leads` enum value from the `type` response property for the response status `201`

[Operation history](https://skmtc.dev/thanks-io/apis/thanks-io-api/changes/mailing-lists/post.md)

---

[API](https://skmtc.dev/thanks-io/apis/thanks-io-api.md) · [All operations](https://skmtc.dev/thanks-io/apis/thanks-io-api/llms.txt) · [OpenAPI document](https://skmtc.dev/thanks-io/apis/thanks-io-api/revisions/c403fbf3dc0f?raw)