---
api: 'Crypto Ramp API'
---

# Update a webhook

Update the details of a specific webhook.

For more information, see the guides: [Work with webhooks -> Track order and payment lifecycle](/docs/guides/crypto-ramp/tutorials/work-with-webhooks/use-webhooks).

## Endpoint

PATCH `/webhooks/{webhook_id}`

## Parameters

### header parameters

- `X-API-KEY` (any, optional)
  Your API key that you received during integration setup. 
  For more information, see the **Authorization** section.

### path parameters

- `webhook_id` (string, required)
  The ID of the webhook.

## Request body

### Attributes

- `url` (string, optional)
    The webhook's URL to which event notifications will be sent.
    Must be a valid HTTP or HTTPS URL, capable of receiving POST requests.
- `events` (array of enum, optional)
    The list of event types that the webhook is configured to listen to.

## Returns

### 200

The successfully updated webhook

#### Response attributes

- `id` (string)
    The UUID of the webhook.
- `url` (string)
    The webhook's URL to which event notifications will be sent.
    Must be a valid HTTP or HTTPS URL, capable of receiving POST requests.
- `events` (array of enum)
    The list of event types that the webhook is configured to listen to.
- `signing_secret` (string)
    The [signing secret](/docs/guides/crypto-ramp/tutorials/work-with-webhooks/verify-the-payload-signature#webhook-signing-secret) for the webhook.
    Use it to verify the signature for the webhook's request payload.

## Error responses

| HTTP status code | Description |
| --- | --- |
| 400 | Bad request  A request parameter is invalid. |
| 401 | Unauthorized |
| 404 | Resource cannot be found |
| 429 | Too Many Requests |
| 500 | Server error  An unexpected error occurred. |
| 503 | The endpoint is disabled by Kill Switch |