Requests - Inbound emails API

List inbound emails of a request

List all inbound emails of a request with a specific ID.

GET /requests/:id/inbound_emails

Response

Status: 200 OK
[
  {
    "id": 9,
    "created_at": "2024-03-14T07:32:38-05:00",
    "message_id": "<xyz>",
    "from": "beatrice.baldwin@widget.com",
    "to": "wdc@r-service.tech",
    "subject": "Upgrade HP OpenView NNM to v10 (NNM10)",
    "body_start": "Our purchase department received a letter from HP announcing the End of Support for ...",
    "source_uri": "https://...",
    "note": {
      "id": 3848,
      "nodeID": "..."
    },
    "failure_reason": null,
    "nodeID": "..."
  },
  "..."
]

The response contains these fields by default.

Collection Fields

By default the following fields will appear in collections of inbound emails:

body_start cc created_at failure_reason from id message_id note source_uri subject to

Obtain a different set of fields using the ?fields= parameter.

Sorting

The collection of inbound emails is sorted ascending by id.

The following fields are accepted by the ?sort= parameter:

id created_at

Fields

body_start
Readonly string — The first 255 characters of the body of the inbound email.
cc
Readonly string — The value of the CC field of the inbound email.
created_at
Readonly datetime — The date and time at which the inbound email was received.
failure_reason
Readonly string — When the inbound email did not process successfully, contains the reason why processing failed.
from
Readonly string — The sender of the inbound email.
id
Readonly integer — The unique ID of the inbound email.
message_id
Readonly string — The value of the Message-ID header of the inbound email. This value always starts with < and ends with >.
note
Readonly reference to Note — The note that was created from the inbound email.
source_uri
Readonly string — An expiring URL that can be used to access the source of the inbound email for a limited time.
subject
Readonly string — The subject of the inbound email.
to
Readonly string — The recipient of the inbound email.