outreach

Connect Byo Mailbox

Connect one BYO SMTP+IMAP mailbox — the UI face of the gateway's POST /v1/mailboxes (T-41 PR-3 contract).

The gateway verifies SMTP login + IMAP select BEFORE inserting anything: bad credentials come back as a 422 with a human-readable detail and zero rows on either side — we pass that detail through verbatim. On success the box is upserted into the org's park right away (targeted single-box sync) and the mailbox's domain gets its outreach_organization_domains row so the DNS checker starts covering it — no ops step in the loop.

The body is validated by hand (not as a typed parameter) on purpose: FastAPI's default RequestValidationError echoes the submitted body as the error input — which would put app_password into a 422 response and into anything that captures 4xx bodies. Field names only, never values.

post/api/app-auto-gtm/outreach/mailboxes

Cookies

ex_accessstring nullable
ex_orgstring nullable

Request body

object required

Response

Successful Response

{"stackTrail":"paths:/api/app-auto-gtm/outreach/mailboxes:post:responses:201:content:application/json:schema","oasType":"schema","type":"unknown"}

Changes

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