Send email

Send a transactional email.

POST/v1/email/send

Overview

Send a transactional email.

Use cases

Use `email.send` when you need send email through the provider-neutral QuoAPI contract.

Authentication

Send a QuoAPI API key as `Authorization: Bearer gi_test_...` or an approved live key. Test and live environments are isolated.

Quick start

Send `POST` to `/v1/email/send`. Start in the test environment and keep the request ID for support and tracing.

Request fields

- `from` — string, required. - `to` — string, required. - `subject` — string, required. - `text` — string, required. - `country` — string, optional. Optional ISO 3166-1 alpha-2 routing context. - `currency` — string, optional. Optional ISO 4217 commercial context.

Response fields

The response envelope contains `data` validated against the canonical response schema and `request_id`. Response schema type: `object`.

Errors

Errors use `error.code`, `error.message`, `error.request_id` and structured `error.details`. Provider names, credentials, upstream URLs and raw upstream errors are not part of the public contract.

Webhooks

Webhook/event metadata is part of this capability.

Rate limits

Rate limits are enforced by API key, organization, plan, capability and environment. Responses include standard rate-limit headers and `Retry-After` when applicable.

Idempotency

Retryable write operations support QuoAPI idempotency semantics so a replay does not create duplicate billing or side effects.

Sandbox

The Playground uses deterministic safe sandbox behavior. Anonymous demos cannot perform purchases, registrations, messages or destructive actions.

Pricing

Usage is measured in `message` and priced in `message` units.

Async behavior

The operation returns through the normal request lifecycle.

Contract version

`1.3.0:email.send` — schema checksum `6d753e30420a32be56c7acf0e8190127fb513727cc663932bbdc2d16decabd73`.

Request schema

{
  "additionalProperties": false,
  "properties": {
    "country": {
      "description": "Optional ISO 3166-1 alpha-2 routing context.",
      "pattern": "^[A-Z]{2}$",
      "type": "string",
      "x-quoapi-hidden": true,
      "x-quoapi-widget": "country"
    },
    "currency": {
      "description": "Optional ISO 4217 commercial context.",
      "pattern": "^[A-Z]{3}$",
      "type": "string",
      "x-quoapi-hidden": true,
      "x-quoapi-widget": "currency"
    },
    "from": {
      "default": "noreply@example.com",
      "format": "email",
      "title": "From",
      "type": "string",
      "x-quoapi-widget": "email"
    },
    "subject": {
      "default": "Hello",
      "title": "Subject",
      "type": "string",
      "x-quoapi-widget": "text"
    },
    "text": {
      "default": "Hello from QuoAPI",
      "title": "Text",
      "type": "string",
      "x-quoapi-widget": "textarea"
    },
    "to": {
      "default": "dev@example.com",
      "format": "email",
      "title": "To",
      "type": "string",
      "x-quoapi-widget": "email"
    }
  },
  "required": [
    "from",
    "to",
    "subject",
    "text"
  ],
  "type": "object"
}

Response schema

{
  "additionalProperties": true,
  "description": "Canonical QuoAPI response data for this capability.",
  "type": "object"
}

Example request

{
  "from": "noreply@example.com",
  "subject": "Hello",
  "text": "Hello from QuoAPI",
  "to": "dev@example.com"
}

Try in Playground

Code examples

curl

curl -X POST "https://api.quoapi.com/v1/email/send" \
  -H "Authorization: Bearer $QUOAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"from\": \"noreply@example.com\", \"to\": \"dev@example.com\", \"subject\": \"Hello\", \"text\": \"Hello from QuoAPI\"}"

javascript

const response = await fetch("https://api.quoapi.com/v1/email/send", {
  method: "POST",
  headers: {Authorization: `Bearer ${process.env.QUOAPI_API_KEY}`, "Content-Type": "application/json"},
  body: JSON.stringify({"from": "noreply@example.com", "to": "dev@example.com", "subject": "Hello", "text": "Hello from QuoAPI"})
});
const data = await response.json();

typescript

const response = await fetch("https://api.quoapi.com/v1/email/send", {
  method: "POST",
  headers: {Authorization: `Bearer ${process.env.QUOAPI_API_KEY}`, "Content-Type": "application/json"},
  body: JSON.stringify({"from": "noreply@example.com", "to": "dev@example.com", "subject": "Hello", "text": "Hello from QuoAPI"})
});
const data = await response.json();

php

<?php
$ch = curl_init("https://api.quoapi.com/v1/email/send");
curl_setopt_array($ch, [CURLOPT_CUSTOMREQUEST => "POST", CURLOPT_HTTPHEADER => ["Authorization: Bearer ".getenv("QUOAPI_API_KEY"), "Content-Type: application/json"], CURLOPT_POSTFIELDS => "{\"from\": \"noreply@example.com\", \"to\": \"dev@example.com\", \"subject\": \"Hello\", \"text\": \"Hello from QuoAPI\"}", CURLOPT_RETURNTRANSFER => true]);
echo curl_exec($ch);

python

import os, requests
response = requests.request("POST", "https://api.quoapi.com/v1/email/send", headers={"Authorization": "Bearer " + os.environ["QUOAPI_API_KEY"]}, json={'from': 'noreply@example.com', 'to': 'dev@example.com', 'subject': 'Hello', 'text': 'Hello from QuoAPI'})
print(response.json())

csharp

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new System.Net.Http.Headers.AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("QUOAPI_API_KEY"));
var response = await client.PostAsJsonAsync("https://api.quoapi.com/v1/email/send", {"from": "noreply@example.com", "to": "dev@example.com", "subject": "Hello", "text": "Hello from QuoAPI"});

java

var request = java.net.http.HttpRequest.newBuilder(java.net.URI.create("https://api.quoapi.com/v1/email/send"))
  .header("Authorization", "Bearer " + System.getenv("QUOAPI_API_KEY"))
  .header("Content-Type", "application/json")
  .method("POST", java.net.http.HttpRequest.BodyPublishers.ofString("{\"from\": \"noreply@example.com\", \"to\": \"dev@example.com\", \"subject\": \"Hello\", \"text\": \"Hello from QuoAPI\"}")).build();

payload := strings.NewReader("{\"from\": \"noreply@example.com\", \"to\": \"dev@example.com\", \"subject\": \"Hello\", \"text\": \"Hello from QuoAPI\"}")
req, _ := http.NewRequest("POST", "https://api.quoapi.com/v1/email/send", payload)
req.Header.Set("Authorization", "Bearer "+os.Getenv("QUOAPI_API_KEY"))
req.Header.Set("Content-Type", "application/json")
resp, _ := http.DefaultClient.Do(req)