Skip to Content
Wapitick developers

Errors

Every problem code the API can return, what it means and what to do.

Errors are application/problem+json (RFC 9457). Switch on code: it never changes. doc_url links here.

CodeHTTPTitleMeaning
aal2_required403Two-factor sign-in requiredSign in again with two-factor authentication to do this.
account_suspended403Account suspendedThis account is suspended. Contact support to restore it.
ad_account_not_ready422Ad account is not readyThe connected ad account is not finished setting up on Meta's side yet.
addon_not_available422Add-on not availableThis add-on cannot be bought on your current plan.
adult_learners_only422Adult learners onlyThis pack may only be sold to adult learners.
ai_rate_limited429Too many AI requestsThe assistant is being asked to do too much too quickly. Wait a minute and try again.
already_exists409Already existsSomething with these details already exists.
appeal_window_closed409Appeal window closedThe time allowed to appeal this decision has passed.
below_minimum422Below the minimumThe amount is below the minimum allowed.
business_verification_failed422Business verification failedMeta could not verify this business. Fix the details in Business Manager and try again.
channel_busy409Channel is busyThis channel is already running another job. Wait for it to finish.
channel_not_ready422Channel is not ready to sendThis channel is not connected or not approved to send yet.
channel_rate_limited429Channel send rate limit exceededWhatsApp is throttling this number. Sending will resume shortly.
channel_unhealthy422Channel needs attentionThis channel has a problem that must be fixed before it can be used.
confirmation_required422Confirmation requiredConfirm this action to continue.
conflict409ConflictSomeone changed this at the same moment. Retry the request.
consent_missing422No consent to message this contactThis contact has not opted in, so you cannot message them.
contact_opted_out422Contact has opted outThis contact asked to stop receiving messages.
country_locked409Country is lockedThe billing country cannot be changed once a subscription is active.
coupon_invalid422Coupon is not validThis coupon code is wrong, expired, or does not apply to this plan.
daily_limit_reached422Daily spending limit reachedThis action would go over the daily spending limit set for the assistant. Raise the limit in Settings or try again tomorrow.
degraded503Temporarily degradedWe are running slowly right now. Try again in a few seconds.
discount_rejected422Discount rejectedThe store would not accept this discount.
entitlement_required402Your plan does not include thisThis feature is not part of your plan. Upgrade to use it.
export_expired410Export expiredThis export has expired. Generate a new one.
feature_unavailable422Not availableThis feature is not available for this account, channel or region.
forbidden403ForbiddenYou do not have access to this.
four_eyes_required409Second approver requiredAnother authorised person must approve this before it can happen.
gone410GoneThis link or resource no longer exists.
helper_invalid422Helper is not validThis helper's configuration is incomplete or invalid.
idempotency_in_progress409A request with this Idempotency-Key is in progressThe same request is still being processed. Wait and read the result.
idempotency_key_required400Idempotency-Key header is requiredThis write needs an Idempotency-Key header.
idempotency_key_reuse422Idempotency-Key was reused with a different requestThis Idempotency-Key was already used for a different request body.
impersonation_denied403Impersonation deniedStaff impersonation is not allowed for this action or account.
impersonation_inactive403Staff session is not activeThis staff session is no longer active. Start a new one.
impersonation_org_locked403Account locked for staff sessionsThis account has blocked staff access.
impersonation_read_only403View-as sessions are read-onlyA view-as staff session cannot change anything.
insufficient_balance402Insufficient balanceYour wallet does not have enough balance. Top up to continue.
insufficient_call_balance402Insufficient call balanceYour calling balance is too low to place this call. Top up to continue.
insufficient_scope403Insufficient scopeThis API key or token is missing the scope this endpoint needs.
integration_connect_failed422Could not connect the integrationWe could not complete the connection. Try connecting again.
integration_credentials_missing409Integration credentials missingThis integration has no saved credentials. Connect it first.
integration_not_connected409Integration is not connectedConnect this integration before using it.
integration_reauth_required409Integration needs reconnectingThis integration's access expired. Reconnect it.
integration_scope_missing409Integration permission missingThe connected account did not grant a permission this needs. Reconnect and approve it.
internal_error500Internal errorSomething went wrong on our side. Try again; contact support if it keeps happening.
invalid_api_key401Invalid API keyThis API key is wrong, revoked or expired.
invalid_cursor400Invalid cursorThe pagination cursor is not valid. Start from the first page.
invalid_graph422Flow is not validThis flow has a broken or unreachable step.
invalid_request400Invalid requestThe request was not understood.
invalid_signature401Invalid signatureThe webhook signature did not verify.
invalid_token401Invalid tokenThis token is not valid.
ip_not_allowed403IP address not allowedThis API key is restricted to other IP addresses.
kyc_required422Verification requiredComplete business verification before using this.
link_blocked422Link blockedA link in this message is blocked. Remove or replace it.
lint_failed422Checks failedThis content did not pass our checks. Fix the reported problems.
locked423LockedToo many failed attempts. This is locked for a while.
marketing_paused409Marketing is pausedMarketing sends are paused for this account right now.
media_invalid422Media is not validThis file cannot be used: wrong format, too large, or unreadable.
meta_payment_required402Meta payment method has insufficient fundsMeta rejected the send because the WhatsApp payment method has no funds.
meta_policy_blocked422Blocked by Meta policyMeta blocked this because of their messaging policy.
meta_rate_limited429Meta rate limit exceededMeta is throttling this account. Try again shortly.
method_not_allowed405Method not allowedThis endpoint does not accept that HTTP method.
no_calling_number422No calling numberAdd a phone number for calls first, then try again.
no_eligible_recipients422No eligible recipientsNobody in this audience can be messaged right now.
not_acceptable406Not acceptableWe cannot produce any of the formats you asked for.
not_eligible422Not eligibleThis account or record does not qualify for this action.
not_found404Not foundWe could not find this. It may have been deleted, or belong to another workspace.
number_not_dialable422Number cannot be dialledThis phone number cannot be called from your account.
oauth_not_configured503Sign-in provider not configuredThis sign-in method is not set up on this deployment.
otp_budget_exhausted429Too many codes sentToo many verification codes were sent. Try again later.
otp_invalid422Code is wrongThat verification code is wrong or has expired.
otp_locked429Verification lockedToo many wrong codes. Verification is locked for a while.
otp_required403Verification code requiredEnter the verification code we sent you.
override_limit_exceeded403Override limit reachedYou have used all the manual overrides allowed in this period.
pack_exceeds_mandate_limit422Pack exceeds your auto-pay limitThis top-up is larger than the auto-pay mandate allows. Raise the mandate or pick a smaller pack.
payload_too_large413Payload too largeThe request or file is too large.
payment_evidence_required422Payment evidence requiredAttach proof of payment before continuing.
payment_method_required409Payment method requiredAdd a payment method to continue.
payout_details_required409Payout details requiredAdd your bank or payout details before you can be paid out.
permission_missing422Permission missingThe connected account is missing a permission this needs.
phone_not_verified422No verified mobile numberAdd and verify your mobile number in your profile first.
phone_verification_required403Verify your mobile number before sendingVerify your mobile number before sending messages or offers.
precondition_failed422Precondition failedSomething this depends on is not in place yet.
provider_not_configured503Provider not configuredThis provider is not set up on this deployment.
publish_blocked422Publishing blockedThis cannot be published until the reported problems are fixed.
quota_exceeded422Plan limit reachedYou have reached a limit on your plan. Upgrade or wait for it to reset.
quote_expired409Quote expiredThis price quote has expired. Fetch a new one.
quote_mismatch409Quote no longer matchesThe price changed since you were quoted. Review the new price.
rate_limited429Rate limit exceededToo many requests. Slow down and retry after the given delay.
recently_asked409Asked too recentlyThis contact was asked recently. Wait before asking again.
recipient_invalid422Number cannot receive messagesThis number is not on WhatsApp, or cannot receive messages from you.
region_not_available422Not available in this regionThis is not available in your country yet.
reveal_reason_required400Reason requiredGive a reason before revealing this data.
review_policy_violation422Against review policyAsking for a review this way breaks the platform's review policy.
role_forbidden403Your role cannot do thisYour role does not allow this. Ask an owner or admin.
route_not_found404Route not foundThere is no endpoint at this path.
routing_standby422Another agent holds this conversationAnother teammate is handling this conversation right now.
run_not_started422Run has not startedThis run has not started yet, so there is nothing to act on.
schedule_too_far422Scheduled too far aheadThat date is further ahead than we allow. Pick a nearer one.
schedule_too_soon422Scheduled too soonThat time is too close to now. Pick a later one.
second_confirmation_required409Second confirmation requiredConfirm once more to go ahead with this irreversible action.
second_tap_required422Confirm on screenThe final confirmation has to be an on-screen tap, not a chat reply.
spend_confirmation_mismatch422Spend confirmation does not matchThe amount you typed to confirm does not match the amount being spent.
spend_confirmation_required422Confirm the amountType or tap to confirm the amount being spent.
staff_only403Staff onlyThis is a Wapitick staff endpoint.
staff_session_blocked403Blocked during a staff sessionMessages to customers are never sent while Wapitick staff are signed in to your account.
staff_session_expired401Staff session expiredThis staff session has expired. Sign in again.
state_conflict409Not allowed in this stateThis cannot be done while the record is in its current state.
step_up_required403Re-authentication requiredConfirm your identity again to do this.
tax_id_required422Tax id requiredAdd your GSTIN or tax id before continuing.
template_lint_failed422Template checks failedThis template breaks a WhatsApp rule. Fix the reported problems.
template_not_approved422Template is not approvedThis template is not approved by WhatsApp yet.
template_required422A template message is requiredThe 24-hour window is closed, so you must send an approved template.
test_mode_only403Test mode onlyThis action only works with a test key (wk_test_) or in the test workspace.
test_mode_unsupported403Not available in test modeTest keys cannot do this. Use a live key, or see the test mode guide for what test mode covers.
test_not_sent422Send a test firstSend yourself a test before publishing this.
test_required409Test run requiredRun a test before turning this on.
token_expired401Token expiredYour session expired. Sign in again.
token_revoked401Token revokedThis session was signed out. Sign in again.
trust_tier_limit422Trust tier limit reachedNew accounts have lower sending limits. This will rise as your account builds history.
turnstile_failed422Bot check failedThe bot check did not pass. Try again.
unauthenticated401Authentication requiredSign in to continue.
undo_window_elapsed409Too late to undoThe time allowed to undo this has passed.
unsafe_link422Unsafe linkA link in this content looks unsafe. Remove or replace it.
unsupported_integration422Integration not supportedWe do not support this integration here.
unsupported_media_type415Unsupported media typeThis file type is not accepted.
upstream_error502Upstream errorA provider we depend on returned an error. Try again.
upstream_timeout504Upstream timeoutA provider we depend on took too long. Try again.
upstream_unavailable503Upstream unavailableA provider we depend on is unavailable. Try again shortly.
url_not_allowed422URL not allowedThis URL is not allowed here.
validation_failed400Validation failedOne or more fields are wrong. See errors for the field pointers.
window_closed422The customer service window is closedMore than 24 hours have passed since the customer's last message, so only templates can be sent.
workspace_forbidden403No access to this workspaceYou are not a member of this workspace.
workspace_required400Workspace requiredPick a workspace (send the wapitick-workspace header).

This page as Markdown