> ## Documentation Index
> Fetch the complete documentation index at: https://docs.useorbitcrm.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Solutions to common issues developers encounter when integrating with OrbitForms.

## Common Issues

> [accordion] I'm getting a 401 Unauthorized error
>
> This usually means your API key is invalid or expired. Check that you're using the correct key and that it's included in the Authorization header as a Bearer token. Make sure there are no extra spaces or characters.

> [accordion] 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.

> [accordion] 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 30 seconds (the default delivery timeout, configurable up to 60 seconds). Review the webhook delivery logs in your dashboard for error details.

> [accordion] 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.

> [accordion] 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.

> [accordion] 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.

> [accordion] 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 |

## Still stuck?

Our developer support team is here to help. Include your request ID and any error messages when contacting us.

[Contact Support →](https://docs.useorbitcrm.ai/support/contact.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.