Docs
Swagger

Dashboard · Webhooks

Webhooks overview

Receive signed HTTP deliveries when content, domains, assets, team, or settings change on a macrocontent website.

owner / adminmt_

Where in the app
Open a website → sidebar Webhooks (not buried under Settings). Only the website owner or an admin can manage endpoints.

What you get

Each endpoint is a named HTTPS URL that Macro calls when any of its selected triggers fire. Every delivery includes Macro metadata headers, an HMAC signature, and a JSON body you control with payload modes.

  • Triggers — subscribe to one or many event types (OR semantics)
  • Signing secret — whsec_… for verifying authenticity
  • Delivery log — status, retries, request/response bodies, resend
  • Test send — fire webhook.test without waiting for a real event

Typical uses

Static rebuild

Invalidate CDN or rebuild on content.published.

Ops alerts

Notify Slack/Discord when domains go active or team roles change.

CI / automation

Create endpoints via Management API with settings.webhook:write.

Verify safely

Check X-Macro-Signature with a 5-minute replay window.

Guides in this group

  1. Create an endpoint

    Name, URL, triggers, and secret — step-by-step.

  2. Pick events

    Full catalog of available vs coming-soon triggers — event catalog.

  3. Shape the body

    Envelope, message-only, or custom templates — payload & envelope.

  4. Operate

    Signing, delivery retries, presets, and API — continue with the links below.