---
title: "Create a recipient"
method: POST
path: "/recipients"
tags: ["Recipient"]
---

# Create a recipient

`POST /recipients`

## Request body

- RecipientRequest
  - `name` string — Name of the recipient. Primarely used for your reference, but acts as a fallback when you use the "name" placeholder
  - `email` string — Emailaddress of the recipient
  - `filters` Filter[]
    - `id` string
    - `key` string
    - `value` string
  - `placeholders` Placeholder[]
    - `id` string
    - `key` string
    - `value` string
  - `sites` object[]
    - `id` string — site id
  - `mailinglists` string[]

## Response `201`

Store a new recipient

- Recipient
  - `name` string — Name of the recipient. Primarely used for your reference, but acts as a fallback when you use the "name" placeholder
  - `email` string — Emailaddress of the recipient
  - `filters` Filter[]
    - `id` string
    - `key` string
    - `value` string
  - `placeholders` Placeholder[]
    - `id` string
    - `key` string
    - `value` string
  - `sites` object[]
    - `id` string — site id
  - `mailinglists` string[]
  - `created_at` string — Created at timestamp
  - `updated_at` string — Updated at timestamp

## Other responses

- `422` — Unprocessable Content
- `500` — Server error

---

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