> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orbitforms.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

<AccordionGroup>
  <Accordion title="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>

  <Accordion title="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>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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>

  <Accordion title="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>

  <Accordion title="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>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>

## 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 →](/support/contact)