Skip to main content
PUT
Set the webhook signing secret on the active connection
This is the second half of a two-step connect: Connect a Gateway with the API keys, create the webhook endpoint in the gateway console using the per-connection URL, then paste the secret it issues here. provider accepts stripe, razorpay, or gocardless — the same set as Connect a Gateway, even though the playground’s provider list shows only the first two. The connection id — and therefore its webhook URL — is unchanged. The secret is sealed at rest and never returned; List Gateway Connections only reports whether one is set. webhook_secret is not checked for presence: an empty string is accepted and clears the stored secret.

Response

A bare status object, not a {data} envelope.

Errors

Errors use the standard envelope — see Errors.

Authorizations

Authorization
string
header
required

Tenant API key obtained from POST /auth/register or POST /v1/developer/keys.

Path Parameters

provider
enum<string>
required
Available options:
stripe,
razorpay

Body

application/json
webhook_secret
string

Response

Updated.

status
string
Allowed value: "updated"