Get webhook by ID or name

GET

/api/admin/webhooks/{id}

const url = 'https://example.com/api/admin/webhooks/example';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://example.com/api/admin/webhooks/example \
  --header 'Authorization: Bearer <token>'

Retrieves a specific webhook by ID or name

Authorizations

bearerAuth

Parameters

Path Parameters

required

Webhook ID or name

string

Responses

200

Webhook retrieved successfully

application/json

object

required

Webhook ID

string

name

required

Webhook name

string

url

required

Webhook URL endpoint

string format: uri

events

Events that trigger the webhook

Array<string>

enabled

Whether webhook is active

boolean

secret

Webhook secret for signature verification

string

headers

Custom headers to include

object

key

additional properties

string

payloadSize

Outgoing payload mode

string

Allowed values: full basic none custom

customPayload

JSON template string used as the entire request body when payloadSize is ‘custom’. String values support {{path}} placeholders resolved against {event, data, webhook}; a value that is exactly one placeholder preserves the source value’s type.

string

createdAt

Creation timestamp

number

updatedAt

Last update timestamp

number

Example

{
  "id": "webhook-123",
  "name": "content-update-webhook",
  "url": "https://example.com/webhook",
  "events": [
    "item.created",
    "item.updated",
    "item.deleted"
  ],
  "enabled": true,
  "payloadSize": "full",
  "customPayload": "{\"id\": \"{{data.id}}\", \"msg\": \"Updated {{data.name}}\"}"
}

400

Webhook not found