ConnectCloud Developers

One mailbox (comms:read; desk:admin its ticket mailboxes, hr:recruiting:manage its applicant mailboxes – another module's mailbox answers 404)

GET /api/comms/v1/mailboxes/{id}

Module: Comms · operationId: getMailbox · Tag: Mailboxes · Auth: access token (Authorization: Bearer <accessToken>)

Parameters

Name In Type Required Description
id path string yes

Responses

  • 200 Mailbox (application/json)
  • 404 Error (application/json)

Fields of the 200 answer:

  • address (string): Platform address (ses) or the Microsoft 365 mailbox address (msgraph)
  • archiveFolder (string): Folder processed mail is moved to (msgraph)
  • channelId (string (uuid)): Microsoft 365 connection that reads the mailbox (msgraph)
  • channelName (string): Name of that connection
  • consumer (string): The module the mails go to (one of invoice, desk, recruiting)
  • enabled (boolean): Mails are imported
  • fetchFolder (string): Folder new mail is read from (msgraph)
  • id (string (uuid)): Mailbox id
  • kind (string): ses: a platform address; msgraph: a Microsoft 365 mailbox (one of ses, msgraph)
  • lastError (string): Error of the last import run
  • lastImported (integer): Mails imported by the last run (msgraph) or received in total (ses)
  • lastReceivedAt (string (date-time)): Time of the last received mail
  • lastRunAt (string (date-time)): Time of the last import run (msgraph)
  • name (string): Display name
  • pending (integer): Received mails still waiting for their consumer (state PENDING)
  • previous (array of object): Rotated addresses that are still accepted (ses)
    • address (string): The old address
    • validUntil (string (date-time)): Until when it is accepted
  • progressFolder (string): Folder mail is moved to while it is processed (msgraph)
  • rejectedFolder (string): Folder rejected mail is moved to (msgraph)
  • rev (integer): Revision for optimistic locking (send it back as rev)
  • updatedAt (string (date-time)): Time of the last change
  • updatedBy (string): Who changed the mailbox last

Example 200 answer:

{
  "address": "support@muster-it.example",
  "archiveFolder": "Posteingang/Erledigt",
  "channelId": "5e7a9c1b-3d4f-4a6b-9c8d-0e1f2a3b4c5d",
  "channelName": "Microsoft 365 Muster IT",
  "consumer": "desk",
  "enabled": true,
  "fetchFolder": "Posteingang",
  "id": "3d5f7a9b-1c2e-4f4a-8b6c-8d0e1f2a3b4c",
  "kind": "msgraph",
  "lastImported": 3,
  "lastReceivedAt": "2026-11-18T07:58:41Z",
  "lastRunAt": "2026-11-18T08:00:03Z",
  "name": "Service Desk",
  "pending": 0,
  "progressFolder": "Posteingang/In Bearbeitung",
  "rejectedFolder": "Posteingang/Abgelehnt",
  "rev": 7,
  "updatedAt": "2026-10-21T15:30:00Z",
  "updatedBy": "sophie.huber@muster-it.example"
}

Example request

curl -X GET 'https://api.mbcom.cloud/api/comms/v1/mailboxes/string' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

View as Markdown · Interactive reference · OpenAPI