Search docs

Search the API documentation

Webhook Secret

Each webhook endpoint has a unique secret used to sign outgoing requests. You use this secret to verify that incoming webhooks genuinely came from Artos: the X-Artos-Signature header is the hex-encoded HMAC-SHA256 of the raw request body, keyed with this secret.

Format

Secrets are prefixed with whsec_ followed by a 32-character random string. Use the full string, including the prefix, as the HMAC key:

Secret format
whsec_K7x9mN3pQ2vR8wY5zA4bC6dE1fG0hI
.env
ARTOS_WEBHOOK_SECRET=whsec_K7x9mN3pQ2vR8wY5zA4bC6dE1fG0hI

Security

Shown once only

The webhook secret is displayed once immediately after creating a webhook endpoint in your dashboard. Copy it and store it securely as an environment variable. It cannot be retrieved again — if lost, delete the webhook and create a new one.