SwiftCRM

Troubleshooting

Common mistakes and fixes. All endpoints and headers must match the API reference.

401 Invalid or missing API key

  • Use the project API key from Install/Settings, not a user password.
  • Send it via X-Api-Key: YOUR_KEY or Authorization: Bearer YOUR_KEY.
  • No extra spaces; key is shown only once when created — create a new key if lost.

403 Domain not allowed

The request's Origin or Referer must match a domain listed in the project's Allowed domains. Add your site (e.g. https://yoursite.com) or http://localhost:8000 for local testing.

429 Monthly lead limit reached

Your plan's monthly lead cap is exceeded. Upgrade on the Pricing page or wait until the next billing period.

Leads not showing in dashboard

Confirm you're in the correct project. Check the response: 201 with lead_id means the lead was stored. Refresh the Leads list or check filters.

Widget not loading

Ensure the script src is correct: https://swiftcrm.in/widget/v1/widget.js. Check the browser console for CORS or network errors. Add your domain to Allowed domains.

Still stuck? [email protected]