GMAIL_MAILBOX_ALREADY_CONNECTED
409invalid_requestThis Gmail mailbox is already connected to another account.
Cause
The mailbox has an active owner claim held by a different account, so a second connect cannot take ownership of it.
How to fix it
Disconnect the mailbox from the account that owns it before reconnecting, or connect a different mailbox. Re-authorizing will not resolve this.
Example response
409 GMAIL_MAILBOX_ALREADY_CONNECTED
JSON
{
"error_code": "GMAIL_MAILBOX_ALREADY_CONNECTED",
"error_type": "invalid_request",
"error_message": "This Gmail mailbox is already connected to another account.",
"hint": "Disconnect the mailbox from the account that owns it before reconnecting, or connect a different mailbox. Re-authorizing will not resolve this.",
"docs_url": "https://docs.billerapi.com/errors/GMAIL_MAILBOX_ALREADY_CONNECTED",
"request_id": "d94f5e2a-8c3b-4f1e-9a7d-6b2c1e0f8a34"
}Related
- Error handling — the error envelope shape and how to parse it
- Error code reference — every stable error code
Canonical docs URL: https://docs.billerapi.com/errors/GMAIL_MAILBOX_ALREADY_CONNECTED
Was this page helpful?