GEgetsales
sender_profiles

Start a mailbox connect for a new sender profile

Start connecting a NEW mailbox at TEAM level: gtm mints a one-time hosted link where the OAuth consent or the IMAP form runs, never here. provider pins that page to one flow (google, microsoft, imap_smtp); omitted, the page shows gtm's own picker. A sender profile named after the mailbox is born from the email-accounts.connected delivery. Use start_sender_profile_mailbox_connect to land the mailbox on a sender profile that already exists. 501 while the email half of the bridge is unconfigured.

Contract:

  • MCP tool start_new_sender_profile_mailbox_connect, registry package mcp.unibox/sender_profiles, mount unibox.sender-profiles.
  • Operation action, response envelope action.
  • Flags: none.
post/api/sender-profiles/start-email-connect

Request

  • Base URL
    https://beta.getsales.io/unibox/v1
  • Auth
    HTTP bearer and API key in header Team-SID

Request body

provider'google' | 'microsoft' | 'imap_smtp' nullable

Pins gtm's hosted page to one flow: google or microsoft run the OAuth consent, imap_smtp shows the credentials form. Omitted, the page shows gtm's own picker.

success_redirect_urlstring uri nullable

Where gtm sends the human once the mailbox is connected. gtm follows it only for allow-listed hosts.

Response

action success envelope.

successtrue required
operation'action' required
actionstring required

kebab-case verb; matches the route segment.

itemobject nullable required

Changes

No recorded changes to this operation across all 1 revision of this API.