---
title: "Modify Subscription"
method: PUT
path: "/core/v1/notifications/{id}"
tags: ["Webhook Notifications"]
---

# Modify Subscription

`PUT /core/v1/notifications/{id}`

Updates an existing webhook’s configuration.  This may include changing the callback URL or updating whether the webhook is currently active.

## Path parameters

- `id` integer, required

## Request body

- union
  - object
    - `url` string, uri, required — Optionally update the URL we send the webhook data to
    - `active` boolean — Optionally update if the subscription is currently active
  - object
    - `url` string, uri — Optionally update the URL we send the webhook data to
    - `active` boolean, required — Optionally update if the subscription is currently active

## Response `200`

A successful response.

- ModifySubscriptionResponse
  - `subscription` SubscriptionRecord
    - `active` boolean, required
    - `createDate` string, required
    - `eventName` string, required
    - `id` integer, required
    - `updateDate` string, nullable, required
    - `url` string, required

## Other responses

- `401` — Unauthorized.
- `403` — Forbidden - you do not have permission to perform this action.
- `404` — The requested resource could not be located.
- `405` — Method not allowed.
- `415` — All POST, PUT, PATCH requests for this API must include the `Content-Type: application/json` header in the requests.
- `429` — Rate limit has been exceeded.
- `500` — Internal server error.
- `502` — Bad Gateway
- `504` — Gateway Timeout

---

[API](https://skmtc.dev/name/apis/name-com-core-api.md) · [All operations](https://skmtc.dev/name/apis/name-com-core-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/name/name-com-core-api/revisions/a37d4cbd3991/schema)