CONTACT_NOT_VERIFIED

HTTP status	Retryable
`403`	No

What happened

Your workspace is on the Free Plan, and this contact hasn’t verified yet. On the Free Plan, you can message only contacts who have texted your Free Plan number to verify.

How to fix it

Don’t retry until the contact is verified. In Blujay, go to Contacts and choose Add verified contact, then have the contact text your Free Plan number (Blujay shows a QR code that fills in the text for them). Once Blujay shows them as verified, send again. To message people without verifying them, upgrade to a dedicated phone number.

Example response

An illustrative example. The message wording and the contents of details vary; branch on error.code.

{
  "status": "error",
  "error": {
    "code": "CONTACT_NOT_VERIFIED",
    "message": "Contact not verified",
    "type": "authorization",
    "http_status": 403,
    "retryable": false,
    "doc_url": "https://docs.blujay.io/errors/contact-not-verified",
    "details": []
  },
  "trace_id": "trc_8f2a1c0e4b7d",
  "timestamp": "2026-10-14T17:30:48.000Z"
}

Still stuck?

Email support@blujay.io with the trace_id from the error response. See Errors for the response format.

Overview

Request errors

Authentication

Idempotency

Rate limits and capacity

Sending messages

Chats and groups

Edit and unsend

Media

Contacts

Workflows

Webhooks

Server and availability

CONTACT_NOT_VERIFIED

What happened

How to fix it

Example response

Still stuck?

​What happened

​How to fix it

​Example response

​Still stuck?

What happened

How to fix it

Example response

Still stuck?