Skip to content

How do I send events to my own systems with webhooks?

Get a signed message at your own HTTPS address when an alert fires, a check finishes or a task is done.

Add a webhook address

  1. As a workspace owner, open Settings > Webhooks.
  2. Enter an HTTPS address on your own system, for example `https://hooks.example.com/promptmentions`. It must use port 443 and a public domain name; addresses on private or internal networks are refused.
  3. Choose the events: An alert fired after a check, A check of AI answers finished and A task was marked done. Choose every client or only the clients you pick.
  4. Choose Add webhook address and copy the signing secret shown. It is shown once; we keep it only encrypted.

A workspace can have up to 3 webhook addresses. Send a test event sends an `endpoint.test` message so you can check your receiver.

What is sent

Each message is JSON with an event id, the event type, the time, the workspace id and the client (id, name and website), and a few details: for a finished check, how many answers came back; for an alert, what fired; for a task, its title and a link. It never contains people's names or email addresses, costs, or the AI models used.

Only events that happen after you add an address are sent, and only for the clients it covers. An address limited to some clients never receives another client's events, and if those clients are archived it receives nothing.

Check that a message is really from us

Every message carries a `PromptMentions-Signature` header. Your developer can check it with the secret: the steps and a code example are in the developer guide.

Delivery, retries and pausing

Messages go out every 15 minutes. If your system does not answer with a success status within 5 seconds, the message is tried again after 1, 10, 60 and 360 minutes, 5 tries in all. A redirect counts as a failure and is not followed.

After 10 failed tries in a row the address pauses, and Settings > Webhooks says why. Fix your receiver and choose Resume; events that happened while it was paused are not sent. The Delivery log shows the last 25 messages for each address, kept for 30 days.

A message can occasionally arrive twice. Use its event id (the `PromptMentions-Delivery` header) to ignore repeats.

Still need a hand?

Use the chat button in the corner of the page, send us a message or write to support@promptmentions.com. A person reads every message.

Looking for something else? See what the product does, pricing, how each figure is measured and how your data is protected.

Last checked against the product on 17 November 2026. All help articles