---
title: "Update Subscription"
method: PATCH
path: "/api/subscriptions/{id}"
tags: ["Webhooks"]
---

# Update Subscription

`PATCH /api/subscriptions/{id}`

Updates an existing webhook subscription. All fields are optional.

*Endpoint*: **(PATCH) https://api.lusha.com/api/subscriptions/{id}**

---
**Reactivating Disabled Subscriptions:**

When setting `isActive: true` on a previously disabled subscription, the system automatically:
- Clears the `blockReason` field
- Clears the `blockedAt` timestamp
- Resets the retry counter

**Regenerating Secrets:**

Set `regenerateSecret: true` to generate a new webhook secret. The new secret:
- Affects **all subscriptions** for your account
- Is only shown once in the response
- Immediately invalidates the old secret
---

## Path parameters

- `id` string, required

## Request body

- UpdateSubscriptionRequest
  - `signalTypes` string[] — New signal types to subscribe to
  - `url` string, uri — New webhook URL
  - `name` string — New subscription name
  - `isActive` boolean — Enable or disable subscription
  - `regenerateSecret` boolean — Generate new webhook secret (secret will be returned in response)

## Response `200`

Subscription updated successfully

- SubscriptionResponse
  - `id` string
  - `entityType` 'contact' | 'company'
  - `entityId` string
  - `signalTypes` string[]
  - `url` string, uri
  - `name` string
  - `isActive` boolean
  - `secret` string — Webhook secret (only returned during creation or regeneration)
  - `createdAt` string, date-time
  - `updatedAt` string, date-time

## Other responses

- `400` — Bad request - invalid input data
- `404` — Not found - resource not found
- `500` — Internal server error

---

[API](https://skmtc.net/lusha/apis/lusha-api-documentation.md) · [All operations](https://skmtc.net/lusha/apis/lusha-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lusha/lusha-api-documentation/versions/4c51e40e3e67/schema)