Troubleshooting - Zevari Docs
Common problems and fixes: auth, rate limits, approvals, email sending, replies, and bookings.
Auth fails
Check your zvr_api_ key. A key binds one workspace and one sender, so the wrong key hits the wrong workspace.
Rate limited (429)
You exceeded 600 requests per key per hour. Back off and retry; there is no Retry-After header.
Nothing sent / status_pending
The write is staged and waiting for approval. Approve it. A staged confirmation expires after about 10 minutes; once approved you have about 30 minutes to execute, then you must re-stage.
Unapproved write (400)
You called a gated write without an approved confirmation_id. Stage it first with the approval flow.
Email not sending
The from-address is not a verified sender. Instantly imports verified senders; other providers use your account email. Resend needs a verified domain.
Replies not arriving
Confirm your reply-email setup (tracked alias or custom-domain MX). Instantly cannot use tracked Reply-To.
Bookings not logged
Confirm the booking webhook URL and signing secret are saved in your provider and the booker matches a lead.