Quickstart

Five minutes, no DNS required. You'll send a sandbox email, simulate a bounce, and read the delivery timeline.

1. Create an account and API key

Sign up free, then create a key under API keys. Secrets start with ntc_ and are shown once.

2. Send from the sandbox

The sandbox sender works immediately. Sandbox sends are mocked in local/dev environments and count against your free quota, not your reputation.

curl -X POST https://www.noticeapi.com/api/v1/email/send \
  -H "Authorization: Bearer ntc_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "[email protected]",
    "to": "[email protected]",
    "subject": "Hello from NoticeAPI",
    "text": "It works."
  }'

3. Simulate a bounce — for free

Recipients at simulator.noticeapi.com exercise the full pipeline (delivery events, webhooks, suppression logic) without sending real email or using quota. Try delivered@, bounced@, complained@, or suppressed@.

curl -X POST https://www.noticeapi.com/api/v1/email/send \
  -H "Authorization: Bearer ntc_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "[email protected]",
    "to": "[email protected]",
    "subject": "Bounce test",
    "text": "Watch the delivery timeline."
  }'

4. Read the delivery timeline

Every send returns an id. Fetch it to see per-recipient outcomes:

curl https://www.noticeapi.com/api/v1/emails/EMAIL_ID \
  -H "Authorization: Bearer ntc_xxxxxxxxxxxxxxxxxxxx"

5. Go production

Add a domain under Domains, set the DNS records we give you, verify, and send from any address at that domain. Production sending requires an activated plan — the free tier includes 3,000 emails/month once activated.