Quick-Send API

Dispatch outbound emails through your aliases, compile Markdown into responsive email HTML, stage attachments via presigned URLs, and inspect delivery history.

Quick Reference#

Deliverability Pre-Flight Safeguards#

Every outbound dispatch passes through an automated pre-flight security scanner before mail delivery is attempted:

1. MX Record Resolution: The API queries recipient email domains in real time. Dispatches to domains without valid MX or fallback mail exchangers are rejected with INVALID_RECIPIENT_DOMAIN before consuming sending quotas.
2. Permanent Bounce Suppression: Senders cannot dispatch to addresses that previously generated hard bounces (e.g. invalid recipient mailbox).
3. Reputation Throttle: If 3 or more hard bounces occur within a 1-hour rolling window, outbound dispatching is temporarily throttled with BOUNCE_RATE_LIMIT_EXCEEDED to safeguard your domain's delivery reputation.
4. Executable File Defense: Files matching restricted extensions (.exe, .bat, .cmd, .dll, .apk, .vbs, .js, etc.) are blocked immediately.
5. Recipient Caps: Outbound dispatches are strictly capped at 5 recipients on Pro and 20 recipients on Business (combined To, Cc, and Bcc).

Dispatch Outbound Email#

POST /v1/quick-send

Delivers an email message to external recipients through an alias registered to your account. Supports rich HTML, GitHub-Flavored Markdown with automated CSS inlining, presigned attachments, and automated alias provisioning.

Request Headers#

Request Body Schema#

cURL Example#

curl -X POST "https://api.aliasfleet.com/v1/quick-send" \  -H "Authorization: Bearer afp_4a8f9c1b2d3e4f5a6b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e" \  -H "Idempotency-Key: 7b848df8-7a5f-4a0b-9dfc-e0cb2cb39031" \  -H "Content-Type: application/json" \  -d '{    "from": "billing@company.com",    "to": "client@enterprise.com",    "subject": "Monthly Service Summary",    "markdown": "## Account Summary\n\nYour deployment completed successfully:\n\n* **Nodes**: 12 active\n* **Uptime**: 99.98%\n\n```json\n{\"status\": \"healthy\"}\n```",    "markdown_theme": "card"  }'

Response (200 OK)#

{  "success": true,  "messageId": "<4b9c1d2e-3f4a-5b6c-7d8e-9f0a1b2c3d4e@company.com>",  "sentAt": "2026-09-04T12:30:00.000Z",  "from": "billing@company.com"}

Error Responses#

Presign Attachment Upload#

POST /v1/quick-send/attachments/presign

Generates an authenticated, short-lived presigned upload URL for staging email attachments prior to dispatch. Client applications upload binary payloads directly via an HTTP PUT request.

Request Body Schema#

Response (200 OK)#

{  "success": true,  "uploadUrl": "https://storage.aliasfleet.com/attachments/d3b07384-d113-4674-bc50-a88981298418/quarterly-report.pdf?X-Amz-Signature=...",  "key": "attachments/d3b07384-d113-4674-bc50-a88981298418/quarterly-report.pdf"}

Delete Staged Attachment#

DELETE /v1/quick-send/attachments

Removes an uploaded attachment key from staging storage before an email dispatch takes place.

Request Body Schema#

Response (200 OK)#

{  "success": true,  "message": "Attachment deleted successfully"}

List Sent Emails#

GET /v1/quick-send/sent

Retrieves a paginated list of outbound messages dispatched via Quick-Send.

Query Parameters#

Response (200 OK)#

{  "success": true,  "sentEmails": [    {      "id": "7b848df8-7a5f-4a0b-9dfc-e0cb2cb39031",      "from_email": "billing@company.com",      "to_email": "client@enterprise.com",      "subject": "Monthly Service Summary",      "status": "sent",      "created_at": "2026-09-04T12:30:00.000Z"    }  ],  "total": 1}