ConnectCloud Developers

Mails received at the platform address, newest first (comms:read)

GET /api/comms/v1/mail-intake/mails

Module: Comms · operationId: listMailIntakeMails · Tag: Mailbox import · Auth: access token (Authorization: Bearer <accessToken>)

Reimport them with POST /mailbox-mails/{messageId}/reimport.

Parameters

Name In Type Required Description
state query string Comma-separated states, e.g. PENDING,REJECTED_FINAL
limit query integer 1–200; anything else is 400 invalid (default 50; max 200)
offset query integer 0–10000; anything else is 400 invalid (default 0; max 10000)

Responses

  • 200 Mails (application/json)

Fields of the 200 answer:

  • items (array of InboundMail): Mails of the page
    • attachments (array of string): File names of the attachments
    • channelId (string): Microsoft 365 connection (msgraph only)
    • consumer (string): The module the mail goes to (one of invoice, desk, recruiting)
    • createdAt (string (date-time)): When the mail was imported
    • lastError (string): Why the mail was rejected or failed
    • mailbox (string): The mailbox or platform address the mail came in on
    • mailboxId (string (uuid)): The mailbox that received the mail
    • messageId (string): Graph message id or SES message id
    • receivedAt (string (date-time)): When the mail was received
    • selectedClassification (string): Document type from "[CC:380]" in the subject
    • sender (string): Sender address
    • source (string): msgraph: a Microsoft 365 mailbox; ses: the platform address (one of msgraph, ses)
    • state (string): Import state; PENDING waits for the consumer (one of PENDING, RETRY_MANUAL, ARCHIVED, REJECTED, DEAD_LETTER, COMPLETED, REJECTED_FINAL)
    • subject (string): Subject
    • updatedAt (string (date-time)): Time of the last state change
  • total (integer): Number of matching mails

Example 200 answer:

{
  "items": [
    {
      "attachments": [
        "RE-2026-1187.pdf"
      ],
      "consumer": "invoice",
      "createdAt": "2026-11-18T06:47:13Z",
      "mailbox": "belege-k7m2qa@demo.on.beta.mbcom.dev",
      "mailboxId": "6a8c0e2f-4b5d-4c7e-9a1b-3c5d7e9f1a2b",
      "messageId": "0100018f2c7a1b3e-5d9f4c2a-7b1e-4a6d-9c3f-2e8a1b7d4c6f-000000",
      "receivedAt": "2026-11-18T06:47:12Z",
      "sender": "rechnung@buero-mueller.example",
      "source": "ses",
      "state": "PENDING",
      "subject": "Rechnung RE-2026-1187",
      "updatedAt": "2026-11-18T06:47:13Z"
    }
  ],
  "total": 1
}

Example request

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

View as Markdown · Interactive reference · OpenAPI