---
title: "Add Shared Mailbox"
method: POST
path: "/v1/integrations/outlook/inboxes"
tags: ["integrations", "outlook-inboxes"]
---

# Add Shared Mailbox

`POST /v1/integrations/outlook/inboxes`

## Request

- Base URL: `https://api.mentium.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mentium.io/v1/integrations/outlook/inboxes`
- Auth: HTTP bearer

Add a shared mailbox inbox.

Verifies delegate access first, then creates a new Inbox record
linked to the Outlook integration connection.

## Query parameters

- `integration_connection_id` string, nullable: Outlook integration connection to link the new inbox to.

## Headers

- `mentium-workspace-id` string, nullable

## Request body

- AddSharedMailboxRequest
  - `email_address` string, required
  - `display_name` string, nullable

## Response `200`

Successful Response

- AddSharedMailboxResponse
  - `inbox` InboxSchema
    - `id` string, required
    - `integration_connection_id` string, nullable
    - `provider` 'GOOGLE' | 'MICROSOFT', required
    - `email_address` string, required
    - `display_name` string, nullable
    - `mailbox_type` string, required
    - `enabled` boolean, required
  - `accessible` boolean, required
  - `message` string, required

## Other responses

- `422`: Validation Error

---

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