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).

Symptom: Radius Search returns 422 saying test mode is enabled​

While API Testing Mode is on, a Radius Search bought via the API or Zapier is limited to 5 records per purchase, and a larger record_count is refused with a 422 validation error on that field. Nothing was purchased and your account was not charged.

  1. Send a record_count of 5 or fewer to carry on testing the integration.
  2. To buy a full list, turn test mode off in Account Settings → API Access, under API Settings → Test Mode, then send the request again.
  3. Buying the same list from the dashboard is not capped - the 2,500-record maximum applies there whether test mode is on or off.