Common Issues
I'm getting a 401 Unauthorized error
I'm getting a 401 Unauthorized error
I'm hitting rate limits (429 errors)
I'm hitting rate limits (429 errors)
Implement exponential backoff in your retry logic. Cache responses when possible, use webhooks instead of polling, and batch operations together. Check your plan limits and consider upgrading if needed.
My webhook endpoint isn't receiving events
My webhook endpoint isn't receiving events
Verify your endpoint URL is correct and accessible from the internet. Check that your server responds with a 2xx status within 5 seconds. Review the webhook delivery logs in your dashboard for error details.
Webhook signature verification is failing
Webhook signature verification is failing
Ensure you’re using the raw request body (not parsed JSON) for signature verification. Check that you’re using the correct webhook secret. The signature is computed on the exact bytes received.
I'm getting CORS errors with the embed script
I'm getting CORS errors with the embed script
The embed script should be loaded directly from our CDN. If you’re seeing CORS errors, make sure you haven’t modified the script URL. The script handles CORS automatically.
The embedded form isn't loading
The embedded form isn't loading
Check that the form slug/ID is correct and the form is published. Verify the embed script is loaded before calling OrbitEmbed methods. Check the browser console for JavaScript errors.
Submissions aren't appearing in the API response
Submissions aren't appearing in the API response
Check your pagination parameters - you might need to fetch more pages. Verify you’re using the correct form ID. There may be a slight delay before new submissions appear in the API.
Debugging Tips
- Check the response body for detailed error messages
- Use test API keys during development
- Review webhook delivery logs in your dashboard
- Check browser console for JavaScript errors
- Verify your request headers are formatted correctly
- Use tools like Postman or curl to test API calls directly
HTTP Status Codes
| Code | Meaning |
|---|---|
200 | Success |
201 | Created |
400 | Bad Request - Check your parameters |
401 | Unauthorized - Invalid API key |
403 | Forbidden - Insufficient permissions |
404 | Not Found - Resource doesn’t exist |
429 | Too Many Requests - Rate limited |
500 | Server Error - Contact support |