Skip to content
Transactional and marketing email

Send emails with the HTTPS API

A POST with your API key: fields, idempotency and what each response means.

  1. In Transactional Email → API and SMTP, click New credential and choose API key.
  2. Copy it right away: we won't show it again. Store it as an environment variable in your system, never in browser code.
  3. Send a POST like the one below, with a sender on a verified domain.

Example

URL
https://fodenflow.com/api/v1/envios/mensajes
Headers
Authorization: Bearer ffe_… Content-Type: application/json Idempotency-Key: order-1001
Body
{"from":"My Store <[email protected]>","to":["[email protected]"],"subject":"We got your order","html":"<p>Thanks!</p>","text":"Thanks!","reply_to":"[email protected]","tags":["order"]}

Fields

  • from: "Name <addr@yourdomain>" (verified domain).
  • to: one address or a list of up to 50 (each is sent separately).
  • subject and html or text (or both), up to 1 MB in total.
  • reply_to, tags (up to 10) and headers (only X-… and List-Unsubscribe), optional.

Responses

  • 202: queued. Returns each recipient's id; check its status with GET /api/v1/envios/mensajes/<id>.
  • 401: wrong or revoked key. 403: unverified sender or paused account.
  • 429: you hit a cap (monthly, daily or per minute): the message says which.
  • 413: the content is too large.

With Idempotency-Key you can retry safely: for 24 hours, the same key returns the same response and never sends twice.

Ask the assistant

Still have a question about this? Ask the assistant.

Was this article helpful?

Related articles

Didn't find what you were looking for?

There are real people on the other end who know your account. Choose how you'd like to reach us.

System statusSomething not working? See if there's a general issue.