Log Error Codes
On Logs (/logs), the Error code shown in failed-send details is always one of the values below. The dashboard API exposes the same as errorCode on GET /api/logs (server-derived from stored fields; not the same as errorMessage).
Codes (closed set)
| Code | Meaning |
|---|---|
DELIVERED_NOT_CONFIRMED | Message was sent successfully, but delivery confirmation did not arrive before the deadline (deliverUntil); marked FAILED after the deadline. |
TEMPLATE_VERSION_NOT_FOUND | Template or template version not found for the message. |
INVALID_DESTINATION | Invalid destination or E.164 normalization failed. |
PILOT_SELF_NUMBER | Blocked send to Pilot Status’s own number on the Pilot Status instance. |
NEVER_ATTEMPTED_MAX_AGE_EXCEEDED | Message remained QUEUED for 7 days with zero send attempts (instance was offline the entire time); expired after automatic deadline checks. |
EXPIRED_AFTER_ATTEMPTS | deliverUntil passed after at least one real send attempt. The delivery window expired while the destination was unreachable. |
MESSAGE_EXPIRED | Legacy: deliverUntil expiration or older expiration behavior not covered by the codes above. |
DELIVERY_TIMEOUT | Delivery timeout, disconnected/closed instance, instance not found at provider, or other delivery failures without a more specific code above. |
NUMBER_NOT_FOUND_REMOVED | The connected instance/number was removed at the provider. |
LINKED_WHATSAPP_INSTANCE_NOT_FOUND | The API key was linked to a WhatsApp instance that no longer exists (removed record or invalid id). |
WHATSAPP_NOT_EXIST | The destination number is not registered on WhatsApp (provider response indicating number not registered). |
META_TEMPLATE_NOT_APPROVED | Template not approved for Meta Cloud API. Template must be submitted and approved by Meta before sending messages via a Meta number. |
META_OUTSIDE_24H_WINDOW | 24h conversation window closed. Use an approved template to message this number. |
META_NO_CONVERSATION | No conversation exists with this number. Start with an approved template. |
META_RATE_LIMITED | Meta sending limit reached. Wait a few minutes and try again. |
META_TOKEN_INVALID | Meta token is invalid or expired. Update the System Token in number settings. |
META_SEND_FAILED | Generic Meta Cloud API send failure. |
FREE_FORM_NOT_SUPPORTED | Free-form messages are not supported for this WhatsApp provider. |
NUMBER_CONNECTION_LIMIT_REACHED | A single WhatsApp number has reached its 4-connection cap. Remove an existing connection before adding a new one. HTTP 409. |
META_WABA_NOT_ACCESSIBLE | The WABA (WhatsApp Business Account) ID associated with this number does not exist or the system token lacks permission to access it. Returned when “Sync with Meta” fails with Meta error code 100 / subcode 33. |
SEND_FAILED | All other failures (including HTTP or provider send errors, generic diagnostic messages, and any case without a more specific code above). |
A
CANCELED message (canceled via DELETE /v1/messages/cancel) is not a delivery error and does not carry one of these codes.