Quickstart

Get your API keyCopy Anchor Link

After creating your account and workspace, open Credentials in the sidebar and create a new credential:

• Product: Sending
• Mode: Production (or Sandbox for testing)
• Stream: Transactional
• Channel: API

Copy the API key: it's shown only once. The key looks like this:

ml_pet_Ab3Kx9mN2pQ7rT4wL8yD...

The prefix encodes the credential type:

• ml_: all MailLand keys start with this
• p or s: Production or Sandbox mode
• e, i, or v, Sending/Email, Inbound, or Validation product (Sending keys also carry a stream letter: et for transactional, em for marketing, e.g. ml_pet_...)

Send an emailCopy Anchor Link

Make a POST request to the send endpoint with your email details:

curl -X POST https://api.mail.land/v1/transactional/send \
  -H "X-API-Key: ml_pet_Ab3Kx9mN2pQ7rT4wL8yD..." \
  -H "Content-Type: application/json" \
  -d '{
    "from": {
      "email": "[email protected]",
      "name": "Your App"
    },
    "to": [
      {
        "email": "[email protected]",
        "name": "Jane Doe"
      }
    ],
    "subject": "Welcome to our platform",
    "htmlContent": "<h1>Welcome!</h1><p>Thanks for signing up.</p>",
    "textContent": "Welcome! Thanks for signing up."
  }'

Check the responseCopy Anchor Link

A successful response returns 202 Accepted with details about the queued email:

{
  "success": true,
  "jobId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "messageIds": ["t_a1b2c3d4e5f6..."],
  "acceptedRecipients": ["[email protected]"],
  "rejectedRecipients": [],
  "queuedAt": "2026-02-17T10:30:00Z",
  "isSandboxed": false
}

Key fields:

• jobId: unique identifier for tracking this send operation
• messageIds: individual message IDs (prefixed t_ for transactional, m_ for marketing)
• acceptedRecipients: emails that were accepted for delivery
• rejectedRecipients: emails that were rejected (with reasons)
• isSandboxed: true if the request used a sandbox credential: the email was logged but not sent, or sent only to allow-listed recipients