---
title: "Authorize Mailbox"
method: POST
path: "/email/mailboxes/authorize"
tags: ["email"]
---

# Authorize Mailbox

`POST /email/mailboxes/authorize`

Start the Composio OAuth dance for a mailbox and return the redirect URL.

## Query parameters

- `provider` string, required — gmail | outlook
- `backfill_months` integer — 6 or 12

## Response `200`

Successful Response

- MailboxAuthorizeResponse — Redirect URL to send the browser to for the Composio OAuth consent.
  - `redirect_url` string, required

## Other responses

- `400` — Provider not configured in Composio
- `422` — Invalid provider or backfill window

---

[API](https://skmtc.dev/getanana/apis/cleon-api.md) · [All operations](https://skmtc.dev/getanana/apis/cleon-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getanana/cleon-api/revisions/3ad158624c53/schema)