Sign in
Webhooks V2

Update Webhook Endpoint

Updates a webhook endpoint's URL, description, or other settings. Requires webhooks:write scope.

patch/v2/projects/{project_id}/webhook_endpoints/{endpoint_id}

Path parameters

project_idstring required

Project ID

Project ID

endpoint_idstring required

Webhook endpoint ID

Webhook endpoint ID

Query parameters

format'superwall' | 'superwall_v2'

Which webhook delivery application this endpoint belongs to. superwall_v2 receives typed Superwall V2 payloads. Defaults to superwall.

Which webhook delivery application this endpoint belongs to. superwall_v2 receives typed Superwall V2 payloads. Defaults to superwall.

Request body

urlstring

The URL where webhook events will be sent

descriptionstring nullable

Description of the webhook endpoint

filter_typesstring[]

List of event types to filter

disabledboolean

Whether the webhook endpoint is disabled

metadataobject

Arbitrary key-value metadata

headersobject

Custom headers to include with webhook requests

Response

Success

idstring required

Unique identifier for the webhook endpoint

object'webhook_endpoint' required

Object type, always webhook_endpoint

urlstring required

The URL where webhook events are sent

descriptionstring nullable required

Description of the webhook endpoint

versionnumber required

Webhook endpoint version

disabledboolean required

Whether the webhook endpoint is disabled

filter_typesstring[] nullable required

List of event types being filtered, or null for all events

channelsstring[] nullable required

Webhook channels

headersobject

Deprecated compatibility field. Stored header values are never returned; use header_names instead.

secretstring

Deprecated compatibility field. Omitted from ordinary endpoint responses; signing secrets are returned only on creation or rotation.

header_namesstring[]

Names of configured custom headers. Header values are never returned

integration_idstring

Safe integration identifier derived from the managed integration header. Other header values are never returned

format'superwall' | 'superwall_v2'

Which webhook delivery format this endpoint belongs to (superwall or superwall_v2)

created_atstring required

ISO 8601 timestamp of when the endpoint was created

updated_atstring required

ISO 8601 timestamp of when the endpoint was last updated

Changes

No recorded changes to this endpoint across all 1 revision of this API.