HELP / ANALYTICS & API

Pull testimonials with the API and webhooks

Push testimonials into your own stack with webhooks, or pull them with the REST API.

1 MIN READ

Everything here is under Workspace settings → Integration, and requires the Pro plan.

Webhooks, API keys and the API reference.
Webhooks, API keys and the API reference.

Webhooks

A webhook POSTs a signed JSON payload to your URL when a testimonial arrives from a form or a manual add. Video fires once processing finishes. Bulk imports deliberately do not fire — a 500-row spreadsheet would otherwise flood your endpoint.

Payloads are signed with HMAC-SHA256 in the X-Kudo-Signature header. Verify it before trusting a payload; an unsigned endpoint accepts anything anyone sends it.

It works with Zapier and Make via their "Webhooks" triggers, which is the no-code route into a few thousand other tools.

API keys

Create a key under API keys, name it after where it will be used, and store it somewhere safe — you cannot read it back later.

Reading testimonials

curl https://app.kudokit.co/api/v1/testimonials -H "Authorization: Bearer kudo_…"

Query parameters: status (approved, pending or rejected) and limit (max 100).

Rate limits

60 requests per minute per key. Over that you get a 429 with a Retry-After header — honour it rather than retrying immediately.


Related

Was this helpful?

Support

Still stuck? Email support.

A human replies — usually within a few hours.

Email support