Get a webhook
One webhook: its URL, events, domains, status and failure count.
GET
https://app.usenotix.dev/api/v1/webhooks/{webhookId}Full access and read only keys can call this. Sending access keys cannot. Key permissions lists the extra rules some calls have.
One webhook: its URL, events, domains, status and failure count. status is ACTIVE, PAUSED, or AUTO_DISABLED when Notix stopped it after repeated failures. The signing secret is masked.
Path parameters
webhookIdstringrequired
Headers
Authorizationstringrequired
Bearer followed by your API key.
Errors
403
`SCOPE_DENIED`: a send-only key or a live AI key. `DOMAIN_PINNED`: the key is limited to one domain, and webhooks carry every domain's events.
404
No webhook with this id for the calling team.
Every error has the same shape. See all error codes.
curl -X GET "https://app.usenotix.dev/api/v1/webhooks/<webhookId>" \
-H "Authorization: Bearer $NOTIX_API_KEY"
import { Notix } from "notix-js";
const notix = new Notix(process.env.NOTIX_API_KEY);
const { data, error } = await notix.webhookEndpoints.get("wh_123");
Response200
{
"id": "cm1x8f3k20001qz7v5b9d2e4a",
"url": "string",
"description": "string",
"status": "ACTIVE",
"eventTypes": [
"string"
],
"domainIds": [
1
],
"apiVersion": "string",
"consecutiveFailures": 1,
"lastFailureAt": "string",
"lastSuccessAt": "string",
"secretHint": "whsec_••••••••••••••••••••••••",
"createdAt": "string",
"updatedAt": "string",
"source": {
"provider": "resend",
"migratedAt": "2026-10-07T10:05:00.000Z"
}
}