Quickstart

Get your API key

Navigate to app.postkit.eu, then go to Settings > API Keys > Create API Key. Give your key a name and click create.

Copy the key immediately — it starts with pk_live_.

Send your first email

Use the following curl command to send an email through the Postkit API. Replace the API key and addresses with your own:

curl -X POST https://api.postkit.eu/v1/emails \
  -H "Authorization: Bearer pk_live_abc123..." \
  -H "Content-Type: application/json" \
  -d '{
    "from": "You <you@yourdomain.com>",
    "to": ["user@example.com"],
    "subject": "Hello from Postkit",
    "html": "<h1>It works!</h1><p>Your first email, sent from the EU.</p>"
  }'

Here is what each field does:

• from — The sender address with an optional display name
• to — An array of recipient email addresses
• subject — The email subject line
• html — The HTML body of the email

Check the response

A successful request returns a JSON response with the email ID and status:

{
  "id": "em_a1b2c3d4e5",
  "status": "queued"
}

• id — The unique identifier for this email, prefixed with em_
• status: "queued" — The email was accepted and will be delivered shortly