Docs/Knowledge Base

Troubleshooting

Common issues and how to resolve them.

401 Unauthorized

Your request could not be authenticated.

Verify your API key is correct — check for trailing whitespace or truncation.
Ensure the Authorization header uses the format Bearer sk_live_... (or sk_test_... for sandbox).
Confirm the X-Workspace-Id header is present and matches your workspace.
Check that your API key has not been revoked in the Repull dashboard.

You are authenticated but not authorized for this operation.

Using a sandbox key (sk_test_) against the live API, or vice versa.
The PMS account referenced by X-Account-Id is not connected or has been disconnected.
Your API key does not have the required scopes for this endpoint.

The requested resource does not exist.

You have exceeded your rate limit.

Check the Retry-After header for the number of seconds to wait.
Implement exponential backoff: wait 1s, 2s, 4s between retries, up to 3 attempts.
Consider upgrading your plan for higher rate limits (see Rate Limits).
Batch operations where possible to reduce total request count.

Something went wrong on the Repull side.

Retry the request after 30 seconds — most 500 errors are transient.
If the error persists, check the Repull status page for ongoing incidents.
Contact support with the X-Request-Id header value from the response for faster debugging.

You are not receiving webhook events.

Confirm your webhook URL uses HTTPS — HTTP URLs are rejected.
Verify the webhook subscription is active in the Repull dashboard.
Check that your endpoint returns 200 within 10 seconds — timeouts count as failures.
After 10 consecutive failures, webhooks are auto-disabled. Re-enable them in the dashboard.
Test with the webhook test button in the dashboard to send a sample event.