Home Troubleshooting & FAQ How do I fix common Vinci problems?

How do I fix common Vinci problems?

Last updated on Jul 24, 2026

How do I fix common Vinci problems?

When a message fails to send or Vinci pauses mid-response, one of a few things is happening. Use the error message to choose the right fix.

You have run out of credits

If Vinci shows "You've reached your limit" or HTTP 402 with budget_exhausted, the shared Vinci balance is out of credits.

  1. Open Account in the app or visit the Usage page on the Vinci Platform.
  2. Check your credit balance and usage.
  3. Add credits, with a $10 minimum purchase, or enable auto top-up.
  4. Try your message again.

The same balance is used across the web app, mobile apps, API, and Vinci Code, so activity on any of those surfaces can affect what remains. To investigate unexpected usage, review the 7-, 30-, or 90-day view, choose a custom date range, or export a CSV.

Vinci is briefly busy

If Vinci says "Try again in a moment," reports rate_limit_error, or returns HTTP 429, wait a few seconds and retry. Adding credits does not resolve a rate-limit response.

Your API key is the problem

If an API request returns HTTP 401 with authentication_error:

  1. Confirm that you copied the whole key. It should start with vinci_live_.
  2. Check that the key has not been revoked. If it was revoked or lost, issue a new one on the Vinci Platform.
  3. Use Authorization: Bearer YOUR_KEY in the request header.

Other quick fixes

  • Cannot sign in: use the same sign-in method you registered with, try Reset password, and check spam or junk for the verification email. A private browser window can rule out an interfering extension.
  • A file will not attach: each message accepts up to 5 files, with an 8 MB maximum per file. Split or trim a larger file.

For more fixes, read the Troubleshooting guide.

If the response still does not make sense, email support@getsimpledirect.com or use the live-chat widget on the web app's /support page. Include your account email, whether the issue is in the app or API, what you tried, and the exact error. Do not send a full API key.