Troubleshooting

Quick fixes for the issues people hit most often.

A job failed

Failed projects show an error message and guidance describing what went wrong and whether the job can be retried. Failed work isn’t charged, and a retryable job can be re-run from the project.

Read the guidance first

The failure card explains the specific cause — start there before re-submitting, so you don’t hit the same error twice.

Language mismatch

Alignment and transcription are language-specific. If a job fails or the output looks wrong, confirm the language you selected matches the spoken audio. For transcription, try setting the language explicitly instead of relying on auto-detect, and check that the content is one of the supported alignment languages.

Low balance

If a job won’t submit, you may be out of credits and free-tier allowance. Top up on the Billing page, and set a low-balance alert in notification preferences so you’re warned ahead of time. See Billing & credits for details.

Webhooks aren’t arriving

  • Confirm your endpoint is publicly reachable and returns a 2xx quickly.
  • Check you subscribed to the right events and that the webhook isn’t filtered out.
  • Verify the signature correctly — a verification failure on your side looks like a missing delivery.
  • Make handling idempotent so retried deliveries are harmless.

Still stuck?

Open a support ticket from the dashboard or email support@vocasync.io — include the project reference so we can look into it quickly. See Account & notifications for how tickets work.