---
title: "Get Mail Box Auth URL"
method: POST
path: "/mailbox/{mailbox_uid}/auth"
---

# Get Mail Box Auth URL

`POST /mailbox/{mailbox_uid}/auth`

## Request

- Base URL: `https://dc-region.zuperpro.com/api`
- URL: `https://dc-region.zuperpro.com/api/mailbox/{mailbox_uid}/auth`
- Auth: API key in header `x-api-key`

Returns an auth_url for creating a Mail Box grant in Nylas. After the user visits this URL, the OAuth flow completes and the grant_id is saved to the mailbox.

## Path parameters

- `mailbox_uid` string, required

## Response `200`

- object
  - `type` string
  - `data` object
    - `auth_url` string
    - `message` string

## Changes

- **2026-11-03** `3c21bc232e16`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/zuper/apis/zuper-pro-api/changes/mailbox/:mailbox_uid/auth/post.md)

---

[API](https://skmtc.dev/zuper/apis/zuper-pro-api.md) - [All operations](https://skmtc.dev/zuper/apis/zuper-pro-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zuper/apis/zuper-pro-api/revisions/3c21bc232e16?raw)