CONTACT_MUST_TEXT_FIRST

HTTP status	Retryable
`403`	No

What happened

The phone number is on the AI Agent plan, which only replies. For a direct message, the person hasn’t texted that number yet. Group chats aren’t available on these numbers at all, even when everyone in the group has texted the number.

How to fix it

For a direct message, don’t retry: wait for the person to text your number, then reply. For a group chat, or to start conversations yourself, send from a number on a plan that can, or contact support@blujay.io to change the plan.

Example response

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

{
  "status": "error",
  "error": {
    "code": "CONTACT_MUST_TEXT_FIRST",
    "message": "Number only replies to people who text it first",
    "type": "authorization",
    "http_status": 403,
    "retryable": false,
    "doc_url": "https://docs.blujay.io/errors/contact-must-text-first",
    "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_MUST_TEXT_FIRST

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?