Skip to content

Headers

Configure custom HTTP headers to send with your test requests.

Adding Headers

Click Headers to expand the headers section, then add key-value pairs:

HeaderValue
Acceptapplication/json
X-Custom-Headercustom-value

Common Headers

Content-Type

Required for requests with a body (POST, PUT, PATCH):

Content-Type: application/json
Content-Type: application/x-www-form-urlencoded
Content-Type: text/xml

Accept

Specify the expected response format:

Accept: application/json
Accept: text/html
Accept: */*

Custom Headers

Many APIs require custom headers for:

  • API versioning: X-API-Version: 2
  • Request tracking: X-Request-ID:
  • Feature flags: X-Feature-Flag: new-algorithm

Authentication Headers

For Bearer token or API key authentication, use the dedicated Authentication section instead of manually adding headers. This provides:

  • Secure credential storage
  • OAuth2 token refresh
  • Clear configuration

However, you can add custom auth headers if needed:

X-API-Key: your-api-key
Authorization: Custom scheme token

Header Variables

Dynamic values are supported in header values:

VariableDescription
Current Unix timestamp
Current date (YYYY-MM-DD)
Random UUID

Example:

X-Request-ID: {{uuid}}
X-Timestamp: {{timestamp}}

Headers to Avoid

Some headers are set automatically by Pingward:

  • Host - Set based on the URL
  • Content-Length - Calculated from body
  • User-Agent - Set to identify Pingward

Overriding these may cause unexpected behavior.

Pingward - API Monitoring Made Simple