Skip to content
/
Get webhook

Get webhook

Request

Security
authJWT
Path
hookIdstringrequired

Webhook ID

curl -i -X GET \
  'https://docs.pers.ninja/_mock/swagger/hooks/{hookId}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Webhook details

Bodyapplication/json
idstringrequired

Webhook ID

namestringrequired

Human-readable name

descriptionstring

Optional description

targetUrlstringrequired

Target URL where requests are forwarded

urlstringrequired

Public URL to receive webhook requests (format: {baseUrl}/{apiVersion}/hooks/{projectKey}/{hookId})

Example:"https://api.pers.ninja/v2/hooks/b3245237f5e658af.../550e8400-e29b-41d4-a716-446655440000"
isActivebooleanrequired

Whether webhook is active

allowedMethodsArray of stringsrequired

Allowed HTTP methods

Items Enum:"GET""POST""PUT""PATCH""DELETE"
outboundAuthTypestringrequired

Outbound authentication type

Enum:"NONE""BEARER""JWT""HMAC"
hasOutboundCredentialsbooleanrequired

Whether outbound credentials are configured

inboundAllowedSourcesArray of stringsrequired

Allowed inbound sources

Items Enum:"USER""BUSINESS""TENANT""INTERNAL""STRIPE""ANY"
hasInboundSecretbooleanrequired

Whether inbound secret is configured

timeoutMsnumberrequired

Request timeout in milliseconds

createdAtstring, (date-time)required

Creation timestamp

updatedAtstring, (date-time)required

Last update timestamp

Response
{
  "id": "string",
  "name": "string",
  "description": "string",
  "targetUrl": "string",
  "url": "https://api.pers.ninja/v2/hooks/b3245237f5e658af.../550e8400-e29b-41d4-a716-446655440000",
  "isActive": true,
  "allowedMethods": [
    "GET"
  ],
  "outboundAuthType": "NONE",
  "hasOutboundCredentials": true,
  "inboundAllowedSources": [
    "USER"
  ],
  "hasInboundSecret": true,
  "timeoutMs": 0,
  "createdAt": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z"
}