Create Attachment Upload
Attachments
Create Attachment Upload
Generate a presigned URL for uploading an attachment
POST
Create Attachment Upload
Create a presigned URL for uploading an email attachment. After uploading the file to this URL, you must confirm the upload before using the attachment.Documentation Index
Fetch the complete documentation index at: https://docs.mailbreeze.com/llms.txt
Use this file to discover all available pages before exploring further.
Upload Flow
Attachments use a three-step process:- Create Upload - Get a presigned URL (this endpoint)
- Upload File - PUT the file directly to the presigned URL
- Confirm Upload - Notify MailBreeze the upload is complete
- Use Attachment - Include attachment ID when sending emails
Request Body
Original filename (e.g.,
report.pdf). Used for display in email clients.MIME type of the file (e.g.,
application/pdf, image/png).File size in bytes. Maximum 40MB for regular attachments, 5MB for inline images.
Set to
true for embedded images in HTML emails (returns contentId).Examples
Response
Unique attachment ID to use when sending emails.
Presigned URL for uploading the file. PUT your file here.
ISO 8601 timestamp when the upload URL expires (typically 1 hour).
For inline attachments only. Use this in HTML:
<img src="cid:contentId">.Example Response
Example Response (Inline Image)
Limits
| Limit | Value |
|---|---|
| Max file size | 10MB |
| Upload URL validity | 1 hour |
| Attachment validity | 7 days after confirmation |
| Max attachments per email | 10 |
| Max total attachment size per email | 25MB |
Errors
| Code | HTTP Status | Description |
|---|---|---|
ATTACHMENT_TOO_LARGE | 400 | File size exceeds 10MB limit |
INVALID_CONTENT_TYPE | 400 | Unsupported MIME type |
VALIDATION_ERROR | 400 | Missing or invalid parameters |