Quick start

This page takes you from sign-up to your first email.

1. Sign up

Create an account at darzus.com with your email address. Darzus is for customers in the United States. New accounts start on the Free plan, which includes 5,000 emails a month. You can change plans from the Billing page in the dashboard.

2. Add and verify a domain

You can only send live mail from a domain you have verified. Darzus does not send from free mail addresses such as Gmail or Yahoo addresses.

  1. Open Domains in the dashboard and choose Add domain.
  2. Enter the domain you send from, such as example.com.
  3. Add the DNS records that Darzus shows you at your domain registrar. The Domains and DNS records guide explains each one.
  4. Choose Verify.

Darzus shows the domain as verified when the records are in place. Until then, it shows which records are still missing. DNS changes can take time to spread. If a record is missing, wait a while and verify again.

3. Create an API key

  1. Open API keys in the dashboard and choose Create key.
  2. Give the key a name and choose the environment:
  • Test creates a key that starts with dz_test_. It never sends email. Mail sent with it is kept as caught mail.
  • Live creates a key that starts with dz_live_. It sends real email.
  1. Copy the key. Darzus shows it once. Store it in an environment variable, not in your code.

Start with a test key, and switch to a live key when your sending is ready.

export DARZUS_API_KEY="dz_test_replace_with_your_key"

4. Send your first email

Replace hello@example.com with an address on a domain you have verified. A test key accepts a From domain that is not verified yet and keeps the mail as caught mail, so you can try the request before the domain is verified.

curl https://darzus.com/v1/emails \
  -H "Authorization: Bearer $DARZUS_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: welcome-ada-0001" \
  -d '{
    "from": "Example Shop <hello@example.com>",
    "to": "ada@example.com",
    "subject": "Welcome to Example Shop",
    "html": "<h1>Welcome, Ada</h1><p>Thanks for joining.</p>"
  }'

The response includes the ID of the email and its status:

{
  "id": "eml_01jd3k5m7p8h2x6q4r9t",
  "status": "caught"
}

With a live key, the status is sent when the provider accepts the email. The Idempotency-Key header makes retries safe. If a request fails or times out, send it again with the same key, and Darzus will not send the email twice. See the API reference for every field.

5. Check the result

Open Logs in the dashboard. Your email appears with its status, such as sent, delivered, bounced or complained. You can also list emails with GET /v1/emails.

With a test key, open Caught mail instead. It shows the email as it would render, its headers and any warnings a live key would have raised.

Next steps