Skip to content

Client webhook config

GET /api/webhooks/config

Base URL that Neike dispatches to, the final URLs per platform (WhatsApp/Instagram/Facebook), the dispatch switch of each platform and each service, and the URLs of the platform events (marketing, publishing and embedded signup) with the event names that arrive at each one. The shared token (x-webhook-token) is NOT returned: only a masked hint. It is shown in full just once, when it is generated. Requires webhooks:manage.

StatusDescriptionSchema
200—WebhookConfigResponseDto
Terminal window
curl -X GET https://api.neike.dev/api/webhooks/config \
-H "x-neike-api-key: whk_live_…"
FieldTypeDescription
webhook_urlstringrequiredConfigured base URL. Example: "https://tu-backend.com".
webhook_secret_setbooleanrequiredtrue if a shared token (x-webhook-token) is configured. Example: true.
webhook_secret_hintstringrequiredMasked hint of the token so you can recognize it (whsec_…abcd). The full value is only returned when it is generated, just once. Example: "whsec_…abcd".
configuredbooleanrequiredtrue if a webhook_url is configured. Example: true.
signature_headerstringrequiredHeader with which Neike signs each dispatch. Example: "x-webhook-token".
dispatch_urlsDispatchUrlsDtorequired—
dispatch_platformsobjectrequiredDispatch switch, per messaging platform and per service. By default all five are true. It is changed with PATCH /api/webhooks/dispatch/{platform}.
event_urlsEventUrlsDtorequired—