---
title: "Update subscription delivery method"
description: "Changes a subscription's delivery method. Setting `webhook` requires an active `webhookConfigId`. On plans with member seats, set `emailAudience` to `workspace` to email active workspace members."
canonical: https://y2.dev/docs/api/reference/subscriptions/updateDelivery/
---

Endpoint Reference[Subscriptions](https://y2.dev/docs/api/reference/subscriptions)

# Update subscription delivery method

Changes a subscription's delivery method. Setting \`webhook\` requires an active \`webhookConfigId\`. On plans with member seats, set \`emailAudience\` to \`workspace\` to email active workspace members.

`PATCH https://api.y2.dev/api/v1/subscriptions/{subscriptionId}/delivery`

- Operation ID: `updateDelivery`
- Required scopes: `webhooks:manage`
- Contract: https://y2.dev/openapi.json

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `subscriptionId` | path | string | Yes | Stable public subscription ID. |

## Request body

`application/json`: `DeliveryUpdateRequest` (required)

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `deliveryMethod` | `DeliveryMethodEnum` | Yes | Subscription delivery method |
| `emailAudience` | `EmailAudienceEnum` | No | Email recipients for email-capable subscription delivery |
| `webhookConfigId` | string | No | Required when deliveryMethod is "webhook" |

## Responses

| Status | Description | Body |
| --- | --- | --- |
| 200 | Delivery method updated | `DeliveryUpdateResponse` |
| 400 | Invalid request parameters |  |
| 401 | Missing or invalid API key |  |
| 403 | Insufficient permissions or access denied |  |
| 404 | Resource not found |  |
| 429 | Rate limit exceeded (per-key or per-account aggregate) |  |
| 500 | Internal server error |  |

### 200 response fields

| Field | Type | Description |
| --- | --- | --- |
| `data` | object |  |
| `data.id` | string |  |
| `data.type` | string |  |
| `data.delivery` | object |  |
| `data.links` | object |  |
| `meta` | object |  |
| `meta.message` | string |  |
