List webhooks
Every webhook of the team, newest first, with a summary of its last 24 hours: calls delivered (ok), extra attempts it needed (retried) and calls that ran…
https://app.usenotix.dev/api/v1/webhooksFull access and read only keys can call this. Sending access keys cannot. Key permissions lists the extra rules some calls have.
Every webhook of the team, newest first, with a summary of its last 24 hours: calls delivered (ok), extra attempts it needed (retried) and calls that ran out of attempts (failed). The signing secret is never shown here: secretHint is always masked. A read only key can call it; a key limited to one domain cannot.
Headers
Bearer followed by your API key.
Errors
`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.
Every error has the same shape. See all error codes.
curl -X GET "https://app.usenotix.dev/api/v1/webhooks" \
-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.list();
data?.data.forEach((webhook) => console.log(webhook.url, webhook.status, webhook.last24h));
{
"data": [
{
"id": "cm1x8f3k20001qz7v5b9d2e4a",
"url": "string",
"description": "string",
"status": "ACTIVE",
"eventTypes": [
null
],
"domainIds": [
null
],
"apiVersion": "string",
"consecutiveFailures": 1,
"lastFailureAt": "string",
"lastSuccessAt": "string",
"secretHint": "whsec_••••••••••••••••••••••••",
"createdAt": "string",
"updatedAt": "string",
"last24h": {
"ok": null,
"retried": null,
"failed": null
},
"source": {
"provider": null,
"migratedAt": null
}
}
]
}