Attachments

Handle email attachments

Interactions with attachments

Get attachments

get

Get message attachments by inbox_id and message_id.

Authorizations

HeaderAuthBearerAuth

Api-TokenstringRequired

Pass the API token in the Api-Token

Path parameters

account_idinteger · int64 · min: 1Required

Unique account ID

Example: 3229

inbox_idinteger · int64 · min: 1Required

Unique inbox ID

Example: 4015

message_idinteger · int64 · min: 1Required

Unique message ID

Example: 427

Query parameters

attachment_typestringOptional

Attachment type

Example: inline

Responses

200

Lists attachments with their details and download paths.

application/json

401

Returns unauthorized error message. Check your credentials.

application/json

403

Returns forbidden error message. Check your permissions.

application/json

404

Returns not found error message

application/json

get

/api/accounts/{account_id}/inboxes/{inbox_id}/messages/{message_id}/attachments

Node.jsPHPPythonC#Java

const { MailtrapClient } = require("mailtrap");
const client = new MailtrapClient({ token: "YOUR_API_KEY", accountId: "YOUR_ACCOUNT_ID" });
const attachments = await client.testing.attachments.getList(67890, 12345);

[
  {
    "id": 67,
    "message_id": 457,
    "filename": "test.csv",
    "attachment_type": "inline",
    "content_type": "plain/text",
    "content_id": null,
    "transfer_encoding": null,
    "attachment_size": 0,
    "created_at": "2022-06-02T19:25:54.827Z",
    "updated_at": "2022-06-02T19:25:54.827Z",
    "attachment_human_size": "0 Bytes",
    "download_path": "/api/accounts/3831/inboxes/4394/messages/457/attachments/67/download"
  }
]

Get single attachment

get

Get message single attachment by id.

Authorizations

HeaderAuthBearerAuth

Api-TokenstringRequired

Pass the API token in the Api-Token

Path parameters

account_idinteger · int64 · min: 1Required

Unique account ID

Example: 3229

inbox_idinteger · int64 · min: 1Required

Unique inbox ID

Example: 4015

message_idinteger · int64 · min: 1Required

Unique message ID

Example: 427

attachment_idinteger · int64 · min: 1Required

Unique attachment ID

Example: 1591

Responses

200

Returns attachment details and download path.

application/json

401

Returns unauthorized error message. Check your credentials.

application/json

403

Returns forbidden error message. Check your permissions.

application/json

404

Returns not found error message

application/json

get

/api/accounts/{account_id}/inboxes/{inbox_id}/messages/{message_id}/attachments/{attachment_id}

Node.jsPHPPythonC#Java

const { MailtrapClient } = require("mailtrap");
const client = new MailtrapClient({ token: "YOUR_API_KEY", accountId: "YOUR_ACCOUNT_ID" });
const attachment = await client.testing.attachments.get(12345, 67890, 222222);

{
  "id": 70,
  "message_id": 460,
  "filename": "test.csv",
  "attachment_type": "inline",
  "content_type": "plain/text",
  "content_id": null,
  "transfer_encoding": null,
  "attachment_size": 0,
  "created_at": "2022-06-02T19:25:55.687Z",
  "updated_at": "2022-06-02T19:25:55.687Z",
  "attachment_human_size": "0 Bytes",
  "download_path": "/api/accounts/3838/inboxes/4401/messages/460/attachments/70/download"
}