Skip to content
Authrim

Get a webhook configuration.

GET
/api/admin/webhooks/{id}
Code sample: Shell / cURL 
curl --request GET \
  --url https://auth.example.com/api/admin/webhooks/example \
  --header 'Authorization: Bearer <token>'

Get Webhook in the Webhooks area. Use this operation to retrieve webhook data without mutating tenant state.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
id
required
string

Header Parameters

Section titled “Header Parameters ”
X-Tenant-Id
string

Tenant selector for multi-tenant admin requests.

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Webhook response.

Media type application/json
object
webhook
required
object
id
string
tenantId
string
clientId
string | null
scope
string
name
string
url
string format: uri
registrationStates

Account-event registration-state filter. Empty accepts both states; other event families are unaffected.

Array<string>
default: <= 2 items unique items
Allowed values: guest registered
payloadFields

Opt-in event-time fields for account.email.changed and account deletion notifications. Tenant-scoped subscriptions only. Configuration requires admin:webhooks:payload:read in addition to webhook management permission. Existing subscriptions default to no additional fields. Selected email snapshots expire after seven days. Configuration changes cannot grant access to events older than the changed configuration.

Array<string>
default: <= 2 items unique items
Allowed values: email registration_state
events
Array<string>
hasSecret
boolean
headers
object
key
additional properties
string
retryPolicy
object
maxRetries
integer
<= 10
initialDelayMs
integer
backoffMultiplier
number
>= 1
maxDelayMs
integer
key
additional properties
timeoutMs
integer
active
boolean
createdAt
string
updatedAt
string
lastSuccessAt
string | null
lastFailureAt
string | null
key
additional properties
Example 
{
  "webhook": {
    "registrationStates": [],
    "payloadFields": []
  }
}

404

Section titled “404 ”

Error response.

Media type application/json
object
error
string
message
string
error_description
string
key
additional properties
Example generated
{
  "error": "example",
  "message": "example",
  "error_description": "example"
}