Webhooks & API integration
A clean API and webhooks you can trust.
Receive every response as a signed JSON webhook, and use the REST API to read forms, responses and testimonials or record responses from your own interface.
What it does
- Webhooks POST the full JSON event to any URL
- Signed with HMAC-SHA256 in the
X-Rirofeed-Signatureheader - The event name is in the
X-Rirofeed-Eventheader - Retried up to three times with backoff, and logged so you can resend
- API keys per workspace for the REST API
Set it up in a few minutes
- In Rirofeed, go to Integrations, choose Webhook, enter your endpoint URL and a signing secret.
- Verify each request: compute the HMAC-SHA256 of the raw body with your secret and compare it with the signature header.
- For the API, create a key in your workspace settings and send it as a Bearer token.
Events
Choose what gets sent.
Pick one or more events, then narrow them down by form, sentiment, NPS range or star rating.
| Event | When it fires |
|---|---|
| New response | Someone completes a form or clicks a Riro Temperature. |
| Negative feedback | A response with NPS of 6 or below, a 1–2 star rating, a low CSAT, a Freezing or Cold temperature, or negative written sentiment. |
| Testimonial approved | You approve a testimonial in the review inbox. |
Example
Record a response from your own app.
How do I verify a Rirofeed webhook?
Compute an HMAC-SHA256 of the raw request body using your signing secret, and compare it with the X-Rirofeed-Signature header, which is sha256= followed by the hex digest.
Do responses posted through the API sync to my CRM?
Yes. A response recorded through the API is treated like any other, so it reaches your dashboard, integrations and automations.
What happens if a delivery fails?
Rirofeed tries each delivery up to three times, waiting longer between attempts. Every delivery is logged with its result, so you can see what was sent and resend it.
Find out how customers really feel.
Start free with ready-made NPS, CSAT and testimonial forms. Upgrade when you’re ready.