> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usertick.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Usertick runs surveys on websites, by link, by QR code and by email, and collects every response in one inbox with reports, dashboards and workflows. The REST API lives at https://app.usertick.com/api/public/v1 and uses Bearer API keys or OAuth access tokens; the JavaScript SDK is the @usertick/snippet package on npm.

# Send survey responses to a webhook

> Create a webhook endpoint in Settings, send it a test ping, then receive every new survey response at your own URL as a signed JSON request.

You can send each new response to a URL you control, as a signed JSON request, so your own system can store it or act on it. When you finish this guide, Usertick sends every response to the surveys you select to your endpoint as it arrives, and the delivery log shows each request with your endpoint's answer.

## Before you start

* You need an HTTPS address that accepts POST requests. To see the requests before your own server is ready, use a temporary address from a request inspection service, which lists every request it receives.
* Your role has the **Manage integrations** permission. If your account uses two-factor authentication, Usertick asks for a code before it creates the webhook.
* Any plan works, with 1 endpoint on Free, 3 on Starter, 10 on Pro and 25 on Business.

## Create the endpoint

1. Go to **Settings → Developers → Webhooks** and select **New webhook**.
2. Enter a **Name**, such as "Order system", and the **URL**, which must start with `https://`.
3. Under **Survey events**, set **Surveys** to **Only selected surveys** and select your surveys, or set it to **All surveys, including new ones**.
4. Set **When** to **When a response is submitted**.
5. Select **Create webhook**.

![The New webhook panel with Name, URL, Survey events with the Surveys choice, Account notifications and Create webhook](https://mintcdn.com/usertick/b7hHAD5bKMN_XhRp/images/settings-developers-new-webhook.png?fit=max\&auto=format\&n=b7hHAD5bKMN_XhRp\&q=85\&s=8a45498a79d3189ecea31c1729f4c292)

Settings → Developers → Webhooks → New webhook

## Save the signing secret

Right after you create the webhook, Usertick shows the signing secret once. Copy it into your server's configuration, then select **I saved it**. Your server uses the secret to confirm that each request came from Usertick. See [Verify signatures](https://docs.usertick.com/developers/webhooks/verify.md).

## Send a test

Select the endpoint's row to open it, then select **Send test**. Usertick sends a `ping` event and shows your endpoint's answer, such as "Test delivered. Your endpoint responded with 200 in 84 ms." The ping also appears in the request list of your test address.

## Receive a real response

When you answer one of the surveys, Usertick sends a `response.created` event whose `data` holds the response with its answers, its survey and who responded. See [Events](https://docs.usertick.com/developers/webhooks/events.md) for the full body.

Your endpoint should answer with a 2xx status quickly and do its work afterward. Usertick retries failed deliveries, and after 20 failures in a row it stops sending and notifies the members who manage integrations. See [Delivery and retries](https://docs.usertick.com/developers/webhooks/delivery.md).

When your own server is ready, open the endpoint, select **Settings** and replace the URL.

## Send only some responses

**Only these responses** in the endpoint's survey events narrows what the endpoint receives by type, urgency and theme. To filter on answers, such as only detractors, use a workflow instead. Start from the **Send responses to a webhook** template and add a condition under **Only if**. See [Send responses with a workflow](https://docs.usertick.com/integrations/webhooks.md#send-responses-with-a-workflow).

## Check that it works

When you open the endpoint under **Settings → Developers → Webhooks**, the response's delivery is listed as **Delivered**, and **Show details** shows the request body and your endpoint's response. Your test address shows the same request, with the header `X-Usertick-Event: response.created`.

## Related

* [Webhooks](https://docs.usertick.com/integrations/webhooks.md)
* [Webhooks for developers](https://docs.usertick.com/developers/webhooks/overview.md)
* [Events](https://docs.usertick.com/developers/webhooks/events.md)
* [Verify signatures](https://docs.usertick.com/developers/webhooks/verify.md)
* [Delivery and retries](https://docs.usertick.com/developers/webhooks/delivery.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.