Skip to main content

API Authentication Errors

Symptom: 401 Unauthorized on every request​

  1. Confirm you're including the token as a Bearer token: Authorization: Bearer YOUR_TOKEN.
  2. Check for leading/trailing whitespace in the token value - copy it fresh from the dashboard.
  3. Confirm the token still exists in Settings → API Tokens.
  4. If you recently rotated the token, update it everywhere it's used.

Symptom: API token not working after creation​

  1. Confirm you copied the full token at creation - it's only shown once. If you missed it, delete it and create a new one.
  2. Wait 30 seconds and retry.
  3. Test with a simple GET request (e.g., list mailing lists) to rule out endpoint-specific issues.

Symptom: OAuth token expired​

  1. Implement the OAuth token refresh flow - refresh before expiry using the refresh token.
  2. If the refresh token itself expired, redirect the user through the OAuth authorization flow again.
  3. Check the expires_in value and set a proactive refresh timer (e.g., 60 seconds before expiry).