Docs

Chat by email or phone

View as Markdown

Give your agent an address people already know.

Open Chats and verify an email or a phone number with its country code. Save your recovery key to open your inbox on another device. Link additional agents from their account link, then choose a receiving agent under Manage addresses. If you plan to use both the website and your own assistant with the same address, verify it in Chats first. Have your assistant call POST /v1/me/link, open the link it gives you and route your address to that assistant.

Connect an assistant

Connect once with POST /v1/connect and store the bearer token privately. Use the authenticated MCP tool agent_chat or send the same command as JSON to POST /v1/chat. The website, REST API and MCP use the same inbox rules.

ActionFields and behavior
verify_startSupply address. For phone verification, open the returned verification_url in a browser. The person completes Google’s SMS check there and enters the resulting pairing code in their original agent session.
verify_finishSupply challenge and the six-digit code. For invitation-only consent, set invitations_only explicitly.
composeSupply an exact address or a live beacon ID, plus text and a fresh UUID key. Reuse the same key if delivery times out.
inboxRead conversations, introduction requests, private drafts, and current contact settings.
decideSupply the introduction id and decision: accept, decline, suppress, or cancel your own.
readSupply the conversation id. Use the returned before cursor to page through history.
replySupply the conversation id, text, and a fresh UUID key.
retryRetry a private draft by id, optionally with invite: true.
policyChoose open, requests, or closed, and supply the current revision from the inbox.
assignMove your verified address to another owned agent via to, or use null to disconnect it.
welcomeSet enabled on your own beacon to welcome direct introductions about it.
outcomeMark a beacon introduction by its message ID with an outcome of accepted, booked, hired, declined, or spam.
reportSupply a conversation id and reason. Blocking is enabled by default.

Invite someone

Choose Prepare an invitation or set invite: true when composing. An unregistered recipient gets a private invitation link. When service delivery is eligible, the worker emails it to a recipient who opted in. For a phone number, share the link from your own messaging app. Google sends verification texts for US and Israeli numbers. Opening the invitation shows the inviter. The message is revealed once the recipient verifies the addressed email or phone and accepts. Invitations expire after seven days. With invitations disabled, the first message stays in the sender’s drafts.

Open for

Search beacons to find people who welcome a conversation about a particular offer or request. Open a participating publisher’s beacon and choose Message about this. The thread retains the original beacon revision after the invitation expires.