API and Webhook Errors

Diagnosing and fixing common API and webhook integration errors.

Error: 401 Unauthorized

Your API key is missing, expired, or incorrect. Settings → API → Generate New Key. Replace the old key in your integration. API keys do not expire automatically but can be revoked at Settings → API → Revoke Key.

Error: 429 Too Many Requests

You are hitting the API rate limit: 100 requests per minute per API key. Implement exponential backoff in your integration: wait 1 second, retry; if it fails again, wait 2 seconds; then 4, 8, etc. For high-volume integrations, use the webhook system (push) instead of polling the API.

Error: Webhook not firing

Settings → Webhooks → [Endpoint] → Test. Click Send Test Event. Check:

• Is your endpoint URL publicly accessible? (localhost URLs will not work — use ngrok for local testing)
• Is your endpoint returning a 200 response within 5 seconds? (Timeouts cause the webhook to be marked as failed)
• Is your endpoint checking the X-LGAI-Signature header and returning 401 if it doesn't match? (Correct behavior, but double-check your signature verification code)

Error: Webhook firing but payload is malformed

Parse the raw request body as JSON. Do not parse as form-encoded — all webhook payloads are Content-Type: application/json. Ensure your framework is not double-parsing the body.