---
title: "Remove a recipient from a policy"
method: DELETE
path: "/notifications/policies/{id}/recipients/{recipient}"
tags: ["Notification Policies"]
---

# Remove a recipient from a policy

`DELETE /notifications/policies/{id}/recipients/{recipient}`

Delete a recipient from an existing Notification Policy.

## Path parameters

- `id` string, required
- `recipient` string, required

## Headers

- `Authorization` string, required
- `sequence-version` '2024-07-30'

## Response `200`

OK

- NotificationPolicy
  - `id` string, required — Unique ID
  - `createdAt` string, required — Created at
  - `sequenceAccountId` string, required — Sequence Account which this policy matches
  - `name` string, required — Human-readable name
  - `notificationTypes` NotificationType[] — Set of notification types that this policy matches. If not present this policy will cover all notification types.
  - `recipients` string[], required — The webhook URLs or email addresses which will receive notifications, depending on the channel
  - `channel` 'WEBHOOK' | 'EMAIL', required
  - `webhookSecret` string — Webhook secret used to generate a signature header that's sent with an outbound webhook.It can be used to verify the authenticity of received Sequence webhooks. Only available for webhook channel policies.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal Server Error

## Changes

- **2026-07-15** `89ff54cddea4` — 1 warning, 1 info
  - deleted the `header` request parameter `Sequence-Version`
  - added the new optional `header` request parameter `sequence-version`
- **2026-06-09** `e5abd262244e` — 1 warning
  - added the new `WATCHTOWER_TASK_ASSIGNED` enum value to the `notificationTypes/items/` response property for the response status `200`
- **2026-06-09** `874d3d969486` — 1 warning
  - added the new `INVOICE_REMINDER_SENT` enum value to the `notificationTypes/items/` response property for the response status `200`

[Change history](https://skmtc.dev/sequencehq/apis/sequence/changes/notifications/policies/:id/recipients/:recipient/delete.md)

---

[API](https://skmtc.dev/sequencehq/apis/sequence.md) · [All operations](https://skmtc.dev/sequencehq/apis/sequence/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sequencehq/sequence/revisions/e520d2f95b7b/schema)