MImiddesk
webhooks

Update a webhook

Changed on

Updates webhook endpoint settings. Event schemas are managed through the nested event_schemas resource, not through webhook updates.

put/v1/webhooks/{id}

Request

Path parameters

idstring required

Webhook ID

Request body

urlstring

Webhook endpoint URL

secretstring

Secret for webhook signature verification

disabled_atstring

Timestamp when webhook was disabled

enabled_eventsstring[]

Array of event types to subscribe to

oidc_auth_method'private_key_jwt' | 'client_secret'

OIDC authentication method for obtaining access tokens. Required when configuring OIDC. 'private_key_jwt' — requires oidc_client_id, oidc_token_endpoint, oidc_access_token_ttl_seconds. 'client_secret' — requires oidc_client_id, oidc_client_secret, oidc_token_endpoint, oidc_access_token_ttl_seconds. Both methods optionally accept oidc_scope and oidc_resource_uri.

oidc_client_idstring

OIDC client ID. Required for both auth methods.

oidc_client_secretstring

OIDC client secret. Required when oidc_auth_method is 'client_secret'. Write-only; never returned in responses.

oidc_token_endpointstring

OIDC token endpoint URL. Required for both auth methods.

oidc_resource_uristring

Optional. OIDC resource URI (Microsoft-specific; use oidc_scope for standard OAuth 2.0).

oidc_scopestring

Optional. OAuth 2.0 scope for the token request (e.g. "api://<app-id>/.default").

oidc_access_token_ttl_secondsinteger

OIDC access token TTL in seconds. Required for both auth methods.

Response

webhook updated

unknown required

Changes

  • 4c9cd4e834baRevision changes
    • warning

      deleted the header request parameter Authorization

    • info

      the endpoint scheme security bearer_auth was added to the API

  • 668373c892ceRevision changes
    • info

      api operation id updateWebhook removed and replaced with webhooks_updateWebhook