---
title: "Add a mailbox from an organization connection"
method: POST
path: "/v1/org-connections/{orgConnectionId}/mailboxes"
tags: ["Connect"]
---

# Add a mailbox from an organization connection

`POST /v1/org-connections/{orgConnectionId}/mailboxes`

## Request

- Base URL: `https://zernio.com/api`
- URL: `https://zernio.com/api/v1/org-connections/{orgConnectionId}/mailboxes`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/zernio/apis/zernio-api/docs/v1/org-connections/:orgConnectionId/mailboxes/post.ts> (a function with typed inputs; its response is checked against the schema)

Adds one mailbox from an active organization connection, with no sign-in from its user. It becomes a `google` or `microsoft` account on the connection's profile and works with every email, calendar, files and contacts endpoint.

`201` for a new account, `200` when the address was already on the profile and now runs on the organization grant. `account.connected` fires.

## Path parameters

- `orgConnectionId` string, required

## Request body

- object
  - `email` string, email, required
  - `name` string: Display name; defaults to the provider's.

## Response `200`

The mailbox account

- object
  - `data` object
    - `_id` string: The account id to use with every email, calendar, files and contacts endpoint.
    - `platform` 'google' | 'microsoft'
    - `username` string
    - `displayName` string
    - `profileId` string
    - `orgConnectionId` string

## Other responses

- `201`: The mailbox account
- `400`: Invalid request
- `401`: Missing or invalid API key. `code` is `missing_credentials` when no Authorization header was sent and `invalid_credentials` when the key is unknown, revoked or expired.
- `403`: The key cannot write to the profile, the plan cannot take another account, or the address is not on `allowedEmails`.
- `404`: Resource not found
- `409`: `org_grant_incomplete`: the TXT record, the delegation, the consent or a permission is missing, or the connection is not active yet.

## Changes

- **2026-11-10** `a79c233ebf22`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/org-connections/:orgConnectionId/mailboxes/post.md)

---

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