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:

FieldRules
Endpoint URLA 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.
EventsAt 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

GroupEvents
Billingbilling.topup, billing.auto_topup, billing.auto_topup_failed, billing.coupon_redeemed, billing.spend_alert
API keysapi_key.created, api_key.revoked
Membersmember.joined, member.removed, member.role_changed
MCPmcp.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:

ActionDoes
View detailsStatus, success rate and deliveries over 24 hours, subscribed events, and the last 10 deliveries with their HTTP status and timing.
Send test eventSends webhook.test.
EditChange the URL, description and events.
Enable / DisablePause deliveries without deleting the endpoint.
Rotate signing secretIssues a new secret, shown once. The old secret stops working immediately, so update your endpoint right away.
DeleteRemoves the endpoint.

Status

StatusMeaning
EnabledReceiving events.
DisabledPaused by you.
FailingThe 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.

Was this page helpful?

On this page