Skip to Content
InvyteDocs
Outreach & email

Disconnect your mailbox

Remove your Gmail or Outlook connection. Your candidate emails go from Invyte with replies to you; emails still waiting to go from the mailbox are not sent. Reconnecting needs the consent screen again.

POST
/operations/mailbox.disconnect

Authorization

bearer
headerAuthorizationBearer <API key or OAuth token>

An organization API key (ink_live_…, ADR-0124), or the OAuth access token a person's AI client gets from the Recruiter MCP sign-in. Only the Authorization header is accepted.

Header Parameters

Idempotency-Key?string

Makes a write safe to repeat: the same key and input return the first result. Required for agents' writes and for anything a person confirms.

Match^[A-Za-z0-9._:-]+$
Length8 <= length <= 128

Request Body

application/json
  1. body
input*
confirmation?string

The id from a confirm or awaiting_approval Outcome, sent with the same input and key to go ahead.

Response Body

Done. A replay of the same key and input omits output.

application/json
  1. response
status*unknown
output?
actionId*string
Example Request
curl -X POST 'https://www.invyte.ai/api/recruiter/v1/operations/mailbox.disconnect' \  -H 'Content-Type: application/json' \  -d '{  "input": {}}'
Example Response
{  "status": "done",  "output": {    "available": true,    "mailbox": {      "provider": "gmail",      "address": "string",      "state": "connected",      "sendFromMailbox": true    }  },  "actionId": "string"}

Connect your mailbox POST

Connecting needs you in a browser, at Google's or Microsoft's consent screen: this returns the Invyte page (`handoffUrl`) where you connect it, signed in as yourself. Nothing changes until you finish there. Refused when the mailbox isn't offered to you, or another mailbox is connected (disconnect it first).

See your connected mailbox POST

Whether you can send candidate emails from your own Gmail or Outlook, which mailbox is connected, whether it needs a reconnect, and whether your emails go from it.