Skip to main content

Webhook Configuration

Webhooks are configured through the Minteo Board UI. API-based configuration is not supported in v1.

Configuration URL​

Configure at: https://board.minteo.com/developers/hooks

Setting up webhooks​

  1. Navigate to the Developers section in Board
  2. Go to the Hooks tab
  3. Enter your webhook endpoint URL (must be HTTPS)
  4. Save the configuration
  5. Copy your webhook secret (you'll need it for signature verification)
warning

Your webhook secret is shown in the Board and can be viewed at any time. Store it securely in your application (environment variables, secret manager).

Managing your configuration​

Updating the webhook URL​

To change your webhook endpoint:

  1. Go to the Hooks tab in Board
  2. Update the URL field
  3. Save the changes
info

URL changes take effect immediately. There is no URL change history.

Rotating the webhook secret​

To rotate your secret:

  1. Go to the Hooks tab in Board
  2. Click "Rotate Secret"
  3. A new secret is generated immediately
  4. The old secret is moved to "Past Secrets" history
Important

When you rotate the secret:

  • The old secret expires immediately
  • Existing events being retried continue using the old secret (snapshotted at event creation)
  • New events use the new secret

Follow the recommended rotation process to avoid downtime.

Viewing past secrets​

Past secrets are stored in Board for debugging and audit purposes. You can view:

  • The secret value
  • When it was created
  • When it expired
  • Who rotated it

Viewing webhook history​

The Board provides a history view of all webhook deliveries:

  1. Go to the Developers section
  2. Navigate to the Hooks History tab
  3. View all delivery attempts, including:
    • Event type
    • HTTP status code
    • Request and response bodies
    • Retry attempts
    • Timestamps
info

Webhook history is only available through the Board UI. It is not accessible via API in v1.

Separate configurations for Production and Sandbox​

You can configure different webhook URLs for Production and Sandbox environments:

Each environment has its own:

  • Webhook URL
  • Webhook secret
  • Delivery history

Next steps​