Skip to content
Project BlueDocs
Popular pages
Guides / Getting startedQuickstartGet an API key, send your first message, and confirm delivery.API reference / MessagesPOSTSend a messageSend iMessage or SMS, with media, voice memos, and message effects./send-api-messageGuides / IntegrationsWebhooksReceive message and call events at your own endpoint.Guides / Getting startedAuthenticationCreate an API key and authenticate requests with a bearer token.AI tools / AI toolsMCP server & skillConnect Claude, Codex, Cursor, and other AI tools to Project Blue.
↑ ↓ Navigate↵ Openesc Close
Dashboard
For AI agents
View as Markdown

Trial accounts

Trial accounts (accounts still on a trial, before conversion to a paid line) get real API access — not a simulator. Sends are real messages. The difference is that a trial account sends through a shared Project Blue line, and it can only reach destinations that have been verified.

On this page

Verifying a destination

  1. Register the destination in the Project Blue webapp under Settings. This creates a pending verification pinned to your shared line.
  2. The owner of that destination texts the shared line from their own phone. That inbound text is what confirms the verification. There is no way to confirm it from the API or the dashboard.
  3. The destination shows as verified in the webapp, and API sends to it start succeeding.

Destination registration is webapp-only today — there is no API-key equivalent for registering a number or polling verification status yet.

Sending or probing an unverified destination returns 403 with Trial accounts can only message numbers verified on the shared line.

Endpoint availability

Endpoint
Trial
Notes
/send-api-message
Restricted
Verified destinations only. lineId is rejected (see below).
/api-check-imessage-availability
Restricted
Verified destinations only.
/get-lines
Restricted
Returns a trial envelope (empty lines list) instead of owned lines.
/request-line
Available
/get-messages-api
Available
Reads your own messages only.
/get-message-api/:message_handle
Available
Reads a single message you own.
/create-external-contact
Available
/get-external-contacts
Available
/update-external-contact
Available
/get-call-logs-api
Available
/get-flows
Available
List published Workflows. Each id is an opaque UUID string.
/cancel-flow-runs
Available
Webhooks
Available
Inbound/outbound webhook delivery for your account.
/get-effects
Unavailable
This endpoint is not available on trial accounts.
/send-reaction
Restricted
Verified destinations only. iMessage tapbacks.
/send-group-message
Unavailable
Trial accounts cannot create group chats.
/enroll-flow
Unavailable
Flow enrollment is not available on trial accounts.
/start-facetime-call-api
Unavailable
FaceTime calling is not available on trial accounts.
/set-contact-card
Unavailable
Trial sends use a shared Project Blue line whose name and photo cannot be changed.
/get-contact-card
Unavailable
Same gate as /set-contact-card.
/share-contact-card
Unavailable
Same gate as /set-contact-card.
/get-facetime-call-status-api
Available
No dedicated trial gate; only useful if you already have a call_uuid.
/end-facetime-call-api
Available
No dedicated trial gate; only useful if you already have a call_uuid.
lineId is not accepted on trial accounts
Trial sends route through the shared line, so the line is not selectable. Supplying lineId on /send-api-message returns 400 — see the rail.

GET /get-lines on a trial account

Trial accounts do not own a device line. /get-lines returns a trial envelope instead of an array of lines.

Guides