# Register the webhook

Canonical page: https://docs.ovok.com/signals/tutorial/register-webhook

<Effort complexity={1} clients="Console, HTTP" time="5 minutes" />

A subscriber is a Signals client with a webhook URL and a list of events. [Signals webhooks](/signals/standalone/webhooks) describes them in full.

## Add the subscriber [Console] [#add-the-subscriber-console]

1. Open **Signals** › **Webhooks** in the [Console](https://ovok.com/console?ref=docs) and add a subscriber.
2. Enter your public URL from [the last page](/signals/tutorial/local-server#get-a-public-url-terminal), ending in `/signals/webhook`.
3. Choose the event `alert.*`.
4. Choose reach **all**, so it hears about every patient, including ones you add later. [Reach](/signals/standalone/webhooks#reach-which-patients-it-hears-about) lists the choices.
5. Copy the signing secret. The Console shows it once.

<Recording name="signals-webhook-create" alt="Creating a webhook subscriber in the Console's Signals Webhooks tab and copying its signing secret" />

Put the secret in `.env` as `SIGNALS_SIGNING_SECRET` and restart your server. To get a new one later, [rotate it](/api/signals-api---clients/rotate-the-webhook-signing-secret).

## Add the subscriber with the API [Terminal] [#add-the-subscriber-with-the-api-terminal]

[Create a user](/api/signals-api---clients/create-a-user) with the role `SUBSCRIBER` does the same:

```bash
curl --request POST 'https://api.sandbox.ovok.com/v1/signals/api/user' \
  --user "${OVOK_MANAGER_ID}:${OVOK_MANAGER_SECRET}" \
  --header 'Content-Type: application/json' \
  --data '{"role":"SUBSCRIBER","name":"Tutorial alerts","webhookUrl":"https://<your-tunnel>/signals/webhook","events":["alert.*"],"reach":"all"}'
```

The answer carries `signingSecret` once.

## Verify your integration [#verify-your-integration]

Send a test event with [`POST .../webhook/test`](/api/signals-api---clients/send-a-test-event). Your server should print a `webhook.test` line.

1. If it printed nothing, open **Signals** › **Events** and [debug the delivery](/signals/tutorial/debugging).
2. If it answered `400`, check that `SIGNALS_SIGNING_SECRET` holds the new secret and the server restarted.

## Next [#next]

[Debug deliveries](/signals/tutorial/debugging).
