Send requests automatically from your app with the API

To send a testimonial request from your own app, create an API key under Requests, Settings, API, then call our trigger endpoint from your server, for example when an order is delivered or a project is finished.

Create an API key

1. Click Requests in the top menu.
2. Open the Settings tab, then API.
3. Under Your API keys, generate a key. Keys start with treq_.
4. Store the key on your server. Never put it in website code that runs in the browser.

You can revoke a key at any time from the same place.

Call the endpoint

Send a POST request to <https://api.testimonials.ltd/api/requests/trigger/> with the header Authorization: Bearer YOUR_KEY and a JSON body:

• recipient_email (required)
• recipient_name (optional)
• event (optional, a label for what happened, for example order_delivered)
• delay_hours (optional, default 0)
• form_slug (optional, which form to link to)
• template_id (optional, which template to use)

What you get back

• 201 with the request queued or sent.
• 201 with status skipped when the person was asked recently, already left a testimonial, or is suppressed. Skips do not count against your allowance.
• 429 when your plan’s request email allowance is used up.

Let your AI assistant set it up

The API tab has a Hand this to your AI prompt. Copy it into your coding assistant and it will add the call to your app.

Related articles

• Request email limits and why some emails are not sent
• Ask for testimonials inside your product
• Send testimonial requests by email