MailingCore
DocumentationQuickstart

Quickstart

Send your first email with an API key in under 10 minutes.

Follow these steps to send your first transactional email.

  1. Create account and tenant

    Sign up in the MailingCore dashboard. After login you will have at least one tenant; copy its id (you need it in the X-Tenant-Id header).

  2. Generate an API key

    In Settings → API keys, create a key with the email:send scope. Store it in a secrets manager; the full key is not shown again.

  3. Configure environment variables

    On your server (never in the client in production):

    MAILINGCORE_API_KEY=mc_test_xxxx
MAILINGCORE_TENANT_ID=clxxxxxxxx

  4. Send your first email

    Call the API from your backend:

    curl -X POST "https://api.mailingcore.com/emails/send" \
  -H "Authorization: Bearer mc_test_xxxx" \
  -H "X-Tenant-Id: clxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "[email protected]",
    "subject": "Hello from MailingCore",
    "htmlBody": "<p>Your first send.</p>"
  }'

Typical response (async):

{
  "id": "clx9k...",
  "status": "QUEUED",
  "queued": true,
  "position": 1
}

Next steps