API & Integration Errors

Rate limits, webhook delivery, distributor connections, and credential management.

Written By Victor Raessen

Last updated 4 days ago

API & Integration Errors

Troubleshooting Public API errors, webhook delivery, and third-party integration issues.

Rate limiting (HTTP 429)

The Public API allows 500 requests per 10-minute rolling window per tenant.

  • Symptom: 429 Too Many Requests response
  • Check: The Retry-After header tells you how many seconds to wait
  • Fix:
    • Implement exponential backoff — wait and retry with increasing delays
    • Use webhooks instead of polling for change detection
    • Batch operations where possible (e.g., POST /product/batch for up to 100 products)
    • Cache responses to avoid redundant calls

Monitor your usage via X-RateLimit-Remaining response headers.

Webhook delivery failures

IssueCauseFix
Webhooks not firing at allWebhook feature not enabled, or no endpoints configuredCheck Admin > Integrations > Webhooks. Ensure the feature is enabled and at least one endpoint is active.
Webhook returns non-2xx statusYour endpoint is rejecting the payloadCheck your endpoint's logs. Verify it accepts POST requests with JSON bodies and returns 2xx.
Webhook times outYour endpoint takes too long to respondProcess webhook data asynchronously. Respond with 200 immediately, then process in the background.
Duplicate deliveriesRetries after timeout or errorUse the eventId field to deduplicate. Failed deliveries retry with a 2-second delay.

Distributor connection errors

  • Connection test fails — Credentials may have expired or the distributor's API is down. Re-enter credentials and test again.
  • Feed returning empty data — The distributor may have deactivated your account or the price file is temporarily unavailable. Contact the distributor.
  • Price data is stale — Check the last sync timestamp in Admin > Distributors. Use the debug/re-fetch option to force a refresh.

CRM enrichment issues

  • Apollo.io / HubSpot not syncing — Verify the API key or OAuth token at Admin > Integrations. Tokens expire and need periodic renewal.
  • Enrichment data missing — Not all companies/contacts have data available in the enrichment provider. This is expected for smaller or newer companies.

Credential management

Integration credentials (API keys, OAuth tokens, FTP passwords) can expire or be rotated by the provider. When an integration stops working:

  1. Check Admin > Tools > Issues for specific error messages
  2. Navigate to the integration's admin page
  3. Re-enter or refresh the credentials
  4. Test the connection

See Public API for full API documentation and Integrations for third-party setup guides.

See also