---
title: "Add a notification recipient to a form"
method: POST
path: "/websites/{websiteId}/forms/{formName}/recipients"
tags: ["Forms"]
---

# Add a notification recipient to a form

`POST /websites/{websiteId}/forms/{formName}/recipients`

## Request

- Base URL: `https://api.cactal.ai/v1`
- URL: `https://api.cactal.ai/v1/websites/{websiteId}/forms/{formName}/recipients`
- Auth: HTTP bearer

Adds an email address to one form, identified by its name from the action path. New forms notify the organization owners until changed. Organization members and website editors receive submissions immediately; other addresses get a confirmation email (link valid 7 days). `member` and `confirmed` addresses receive email; `pending` addresses must confirm by link; `failing` addresses bounced or complained; `stopped` addresses opted out. Works before the first submission; at most 20 addresses per website.

## Path parameters

- `websiteId` string, required
- `formName` string, required: The form name from the action path.

## Request body

- object
  - `email` string, email, required: Address to notify.

## Response `200`

The recipient.

- object
  - `id` string, required
  - `email` string, required
  - `status` 'member' | 'pending' | 'confirmed' | 'failing' | 'stopped', required
  - `createdAt` string, required

## Other responses

- `400`: Validation failed. The response `message` names the first invalid field.
- `401`: Missing, invalid, expired, or revoked API key.
- `403`: The authenticated principal lacks the required capability.
- `404`: The resource does not exist or is outside the principal’s access scope.
- `429`: Rate limit exceeded. Retry after the number of seconds in the `Retry-After` header.

---

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