Webhooks
Send TestRelic Console events — top-ups, spend alerts, key, member and MCP tool changes — to your own HTTPS endpoint, test it, rotate its signing secret and watch its deliveries.
Webhooks post workspace events to an HTTPS endpoint you run, so your chat, paging or finance tools hear about them as they happen. Manage them in Settings → Webhooks (console.testrelic.ai/settings). Owners and admins can add and change endpoints; everyone can see them.
The payload format, headers and signature verification code (Node.js, Python, Go, Ruby, PHP, Java, C#) are in the Webhooks API reference.
Add an endpoint
Click Add endpoint.
Fill in:
| Field | Rules |
|---|---|
| Endpoint URL | A public https:// URL. Private, loopback and internal addresses are refused, and so are URLs with a username or password in them. |
| Description (optional) | Up to 200 characters. |
| Events | At least one. Select all / Clear all. New endpoints start with billing.topup, billing.spend_alert, api_key.created and api_key.revoked selected. |
Save. The Save your signing secret dialog shows the secret (whsec_…) once. Store it where your endpoint can read it (for example OSTRA_WEBHOOK_SECRET) and use it to verify every delivery.
Click ⋯ → Send test event. Your endpoint receives a webhook.test event with "message": "Test event from TestRelic Console".
A workspace can have up to 10 endpoints.
Events
| Group | Events |
|---|---|
| Billing | billing.topup, billing.auto_topup, billing.auto_topup_failed, billing.coupon_redeemed, billing.spend_alert |
| API keys | api_key.created, api_key.revoked |
| Members | member.joined, member.removed, member.role_changed |
| MCP | mcp.tool_enabled, mcp.tool_disabled |
What each one means: Webhook events. billing.spend_alert is the only notification sent when spend crosses your alert percentage; subscribe to it if you want spend alerts.
Delivery rules
- Your endpoint must answer with a 2xx within 3 seconds. Respond first, then do slow work.
- Redirects aren't followed.
- Failed deliveries aren't retried. Use the audit log (Settings → Audit log) to catch up on anything you missed.
Manage an endpoint
The ⋯ menu on each endpoint has:
| Action | Does |
|---|---|
| View details | Status, success rate and deliveries over 24 hours, subscribed events, and the last 10 deliveries with their HTTP status and timing. |
| Send test event | Sends webhook.test. |
| Edit | Change the URL, description and events. |
| Enable / Disable | Pause deliveries without deleting the endpoint. |
| Rotate signing secret | Issues a new secret, shown once. The old secret stops working immediately, so update your endpoint right away. |
| Delete | Removes the endpoint. |
Status
| Status | Meaning |
|---|---|
| Enabled | Receiving events. |
| Disabled | Paused by you. |
| Failing | The last 3 deliveries failed (non-2xx, timeout or network error). Check View details, fix the endpoint, then Send test event. |
Every change to an endpoint (created, updated, enabled, disabled, secret rotated, deleted) is recorded in the audit log.
Billing & credits
Buy Ostra credit, set up auto top-up, redeem coupon codes, set a monthly spend limit, manage your card and billing details, and find receipts in the TestRelic Console.
Settings
Workspace settings in the TestRelic Console — general details, members, workspaces, sign-in and API key policy, webhooks, the audit log, and data retention and privacy.