Authentication Error

Type URI

https://api.marketingpod.dev/problems/authentication-error

Status Code

401 Unauthorized

Description

The request must include a valid Bearer token in the Authorization header.

Example Response

{
  "type": "https://api.marketingpod.dev/problems/authentication-error",
  "title": "Authentication Error",
  "status": 401,
  "detail": "The request must include a valid Bearer token in the Authorization header.",
  "instance": "/api/v1/integration/req_1704123456789_abc",
  "requestId": "req_1704123456789_abc",
  "timestamp": "2024-10-07T12:34:56.789Z"
}

Common Causes

• Missing Authorization header
• Invalid Bearer token format (should be Bearer {token})
• Expired access token
• Invalid token signature
• Token issued for wrong audience or issuer

How to Fix

1. Obtain a valid access token using OAuth 2.0 Client Credentials flow
2. Include the token in the Authorization header: Authorization: Bearer {token}
3. Ensure token has not expired (tokens typically expire after 3599 seconds)
4. Verify token audience matches api://{tenantId}/{appName}
5. If token is expired, request a new token from the token endpoint

Related Errors

• Authorization Error

Need help? Contact developers@marketingpod.com and include the requestId from your error response.