Register and manage inbound/outbound webhooks via the Kustomer API
domain: developer.kustomer.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
As an admin, generate an API key under Settings > Security > API Keys, selecting an API role to scope its permissions; the key is a signed JWT shown only once at creation time.
Authenticate all API calls with an Authorization: Bearer {API_KEY} header.
Register an outbound webhook via the create-outbound-webhook endpoint, supplying a name, destination url, optional headers, and an events array subscribing to object create/update events (Kustomer's outbound webhooks fire on Customer, Conversation, Message, User, and Team create/update events).
Update an existing outbound webhook's url, headers, or subscribed events via the corresponding update-outbound-webhook endpoint by id, and audit registered inbound web hooks via GET on the hooks/web endpoint (capped at 10 pages of 99 entries).
For inbound data ingestion, pick the right hook type: a 'web' hook requires the API key on incoming requests, a 'form' hook is a public endpoint with no authentication, and an 'email' hook parses JSON/JSON-LD out of emails sent to a generated address.
Check delivery health by listing transactions for a given webhook to confirm events are posting successfully.
Known gotchas
Kustomer retries a failing outbound webhook delivery up to 10 times over roughly an 80-minute window; after 10 consecutive failures it is automatically turned off and must be manually re-enabled.
'Web' inbound hooks require an API key on the request while 'form' hooks are public and unauthenticated — confusing the two can create an open, unauthenticated data-ingestion endpoint.
The web hooks list endpoint caps out at 10 pages x 99 entries, so accounts with a large number of webhooks need a different audit strategy than simple pagination.
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?