Skip to main content

Webhook Request Headers

This guide explains how to use custom headers with your Ownstak webhooks for enhanced security and functionality.

System headers​

Every webhook request from Ownstak includes the following system headers:

HeaderDescription
Content-TypeAlways set to application/json
User-AgentOwnstak Webhook Client/1.0
X-Own-Webhook-IdUnique identifier for the webhook
X-Own-Webhook-Event-IdUnique identifier for the webhook event
X-Own-Webhook-Event-Request-IdUnique identifier for the webhook request

These headers help you identify and validate incoming webhook requests.

Custom headers​

You can add custom HTTP headers to your webhook requests, which is useful for authentication and providing additional context to your endpoint.

Adding custom headers​

  1. In your webhook settings, click the "Add" button in the Request Headers section
  2. Enter the header name (e.g., "Authorization")
  3. Enter the header value (e.g., "Bearer my-token")
  4. Check the "Secret" checkbox if the value contains sensitive information
  5. Click "Create" to add the header

Adding custom headers

Secret headers​

Headers marked as "Secret" will be:

  • Stored securely in our database
  • Masked in logs and webhook event details

This is particularly useful for authentication tokens, API keys, and other sensitive information.