> ## Documentation Index
> Fetch the complete documentation index at: https://docs.salessequencer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Try to reconnect a mailbox

> Re-tests the stored token (Google) or SMTP login. Outcomes: reconnected (status back to active), dead, or temporary error. For a dead Google mailbox it redirects to /mailboxes/connect, which is a browser-only OAuth consent flow and cannot be completed through the API. A dead SMTP mailbox flashes the rejection reason and needs POST /mailboxes/connect-smtp with the right password.

**Minimum role:** `edit` (`x-min-role`). **Destructive:** `false` (`x-destructive`).



## OpenAPI

````yaml /openapi.json post /mailboxes/{mailbox_id}/reconnect
openapi: 3.0.3
info:
  title: Sales Sequencer API
  version: '1'
  description: >-
    Every Sales Sequencer action over HTTP. Each call runs as the API key's
    creator, with that user's role, in the key's workspace. Auth: X-API-Key
    header.
servers:
  - url: https://api.salessequencer.com/api/v1
security:
  - key: []
paths:
  /mailboxes/{mailbox_id}/reconnect:
    post:
      tags:
        - Mailboxes
      summary: Try to reconnect a mailbox
      description: >-
        Re-tests the stored token (Google) or SMTP login. Outcomes: reconnected
        (status back to active), dead, or temporary error. For a dead Google
        mailbox it redirects to /mailboxes/connect, which is a browser-only
        OAuth consent flow and cannot be completed through the API. A dead SMTP
        mailbox flashes the rejection reason and needs POST
        /mailboxes/connect-smtp with the right password.


        **Minimum role:** `edit` (`x-min-role`). **Destructive:** `false`
        (`x-destructive`).
      operationId: mailboxes_reconnect
      parameters:
        - in: path
          name: mailbox_id
          required: true
          schema:
            type: integer
      responses:
        '200':
          description: >-
            Redirect; flash says reconnected, login rejected, or temporary
            error. Poll the mailbox for its new status.
components:
  securitySchemes:
    key:
      in: header
      name: X-API-Key
      type: apiKey

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.