Organizations

List the organization mailboxes (admin)

GET
/api/organizations/{organizationId}/email-accounts

Every EmailAccount in the SELECTED organization, newest first, OAuth tokens excluded, with the linked user's or group's identity flattened in (linkedUserName, linkedUserEmail, linkedGroupName). Each row carries its access grants; the field is omitted for a mailbox that predates grants. Admin or SuperAdmin; an Admin may only list their own organization.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

organizationId*string

The organization that owns the mailboxes.

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/organizations/string/email-accounts"
{  "accounts": [    {      "_id": "665f1a0c0e0a4b001a2c9f50",      "provider": "gmail",      "emailAddress": "leasing@acme.example",      "isActive": true,      "linkedType": "group",      "linkedGroupId": "6650a1b2c3d4e5f6a7b8c9d2",      "linkedGroupName": "Leasing",      "grants": [        {          "principalType": "department",          "principalId": "6650a1b2c3d4e5f6a7b8c9d3",          "key": "dept:6650a1b2c3d4e5f6a7b8c9d3",          "verbs": [            "send"          ],          "grantedBy": {            "type": "user",            "userId": "6650a1b2c3d4e5f6a7b8c9d0"          },          "grantedAt": "2026-09-30T12:00:00.000Z"        }      ]    }  ]}