Email resources overview
Connect endpoint index — send, search tracking, single timeline, and SMTP relay.
Email resources overview
Start here: E-mail — documentation hub.
Transactional Email API v2 on Connect (https://connect.routee.net). All endpoints require Authorization: Bearer {access_token} with OAuth scope transactional_email (or all).
Obtain a token: Get authenticated using your application credentials.
Available resources
| Method | Path | Description | Reference |
|---|---|---|---|
POST | /transactional-email | Queue a transactional email (HTTP send) | Send a transactional email |
POST | /email/tracking | Search delivery logs (paginated) | Search email tracking |
GET | /email/tracking/batch/{trackingId} | Latest status per recipient (batch send) | Get email tracking (batch summary) |
GET | /email/tracking/single/{trackingId}/recipients/{messageId} | Full timeline for one recipient | Get email tracking (recipient timeline) |
GET | /email/tracking/single/{trackingId} | Full event timeline (single message / legacy) | Get email tracking (single message timeline) |
Send — POST /transactional-email
POST /transactional-emailCreates and queues a message. Routed through menshen to the transactional-email service.
| Item | Detail |
|---|---|
| Required body fields | from, to, content |
| HTTP 200 | Message accepted for processing — not inbox delivery |
| Response | { "trackingId": "..." } |
| Callbacks | Optional callback.statusCallback, callback.eventCallback |
Billing is applied automatically against your Transactional Email subscription (Email → Pricing → My Plan on go.routee.net).
Common HTTP 400 errors
| errorCode | Cause |
|---|---|
000000 | Invalid or unverified domain |
000001 | Invalid sender |
000002 | Unverified sender |
000003 | Message size limit exceeded |
000004 | No active subscription |
000005 | Insufficient subscription resources |
Setup: Domain & authorized senders
Tracking — POST /email/tracking
POST /email/tracking| Query param | Description |
|---|---|
dateStart, dateEnd | ISO-8601 UTC range |
trackingId | Optional — narrow to one message's events |
page, size | Pagination (default page 0, size 20) |
Request body: JSON array of search filters, or [].
Log rows typically appear 1–2 minutes after send.
Batch summary — GET /email/tracking/batch/{trackingId}
GET /email/tracking/batch/{trackingId}| Query param | Description |
|---|---|
dateStart, dateEnd | Optional ISO-8601 UTC range |
trackingId | Path — batch id from send response |
Response: { "trackingId": "...", "recipients": [ ... ] } — one latest-status row per to address. Each recipients[].messageId is the timeline key.
Recipient timeline — GET /email/tracking/single/{trackingId}/recipients/{messageId}
GET /email/tracking/single/{trackingId}/recipients/{messageId}| Parameter | Description |
|---|---|
trackingId | Path — batch id from send |
messageId | Path — per-recipient id from batch summary or search list |
include_content | Default false. Set true to include HTML/text body |
Returns a JSON array of events. Empty array when messageId is not part of the batch.
Single timeline — GET /email/tracking/single/{trackingId}
GET /email/tracking/single/{trackingId}Returns a JSON array of ordered events (not a page).
| Query param | Description |
|---|---|
include_content | Default false. Set true to include HTML/text body on events |
SMTP relay (non-HTTP)
Customer MailerQ relay — not a Connect REST path:
| Setting | Value |
|---|---|
| Host | smtp10.amdtelecom.net |
| Auth | Application Id / Application Secret |
| Port 25 | STARTTLS |
| Port 587 | Implicit TLS |
Guide: Transactional Email — SMTP relay
SMTP sends appear in the same tracking endpoints above.
Related products
| Product | Docs |
|---|---|
| Email Validator | Email Validator — validate addresses before send (separate API) |
| Legacy Email v1 | Deprecated — promotional campaigns on email.routee.net |