All Features

Send Email via API Call

Send powerful transactional emails with a single API request—fast, flexible, and dev-friendly.

When you just want to send an email from your app, you shouldn't have to spend hours reading docs or debugging. Our API is simple, so sending an email takes a single call:

  • One straightforward endpoint.
    POST your content and recipient—we do the rest.
  • Works everywhere.
    Use curl, Postman, your language of choice, or even Zapier—any tool that talks HTTP.
  • Instant, reliable.
    Get a clear JSON response so you can monitor, log, or trigger follow-ups (bounces, receipts, anything).
  • Security built-in.
    API keys are required, plus full audit logging and error clarity.

How it works

  1. Grab your API key from the dashboard (free trial is fine!).
  2. POST to https://api.notifiedby.com/v1/email/send/ with your email details.
  3. Get instant feedback from the API: success ID or clear error message.
# Example: Send an email using curl
curl -X POST https://api.notifiedby.com/v1/email/send/ \
-H "Authorization: Api-Key YOUR_API_KEY" \
--form 'recipient="you@example.com"' \
--form 'subject="email from API"' \
--form 'body="<h1>Email from API</h1><p>This is an <strong>HTML</strong> email body.</p>"' \
--form 'plain_body="This is the plain text version of the email body."'

# ...or send as a query string with -d if you prefer
curl -X POST https://api.notifiedby.com/v1/email/send/ \
-H "Authorization: Api-Key YOUR_API_KEY" \
-d "recipient=you@example.com&subject=email from API&body=<h1>Email from API...</h1><p>...</p>&plain_body=...plain text..."
# Success response
{ "id": "8AB1TX7" }
# Error: Missing authentication
{ "detail":"Authentication credentials were not provided." }
# Error: Missing fields
{ "recipient":["This field is required."] }
(The API responds with clear error messages and always uses HTTP status codes.)

Frequently asked

  • Can I send HTML and plain text?
    Yes—just use body for HTML and plain_body for text-only clients.
  • What if I forget a required field?
    You’ll get a friendly 400 response, listing exactly which parameter is missing.
  • Is this only for curl?
    Nope! Use Python’s requests, Go, JavaScript fetch, anything that can call an HTTP API.
  • Can I test without a paid plan?
    You get a free sender + test quota—so you can start integrating right away.

Try sending via API yourself

Start Your Free Trial All Features Full API Docs
Copy, paste, send! Simplest transactional email API you'll ever try.