> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mailofly.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Http

# HTTP / cURL Quickstart

Send email with plain HTTP — no SDK required.

**Requires:** [API key](api-keys.md)

Base URL: `https://api.mailofly.com/v1`

***

## 1. Discover the API (no auth)

```bash theme={null}
curl https://api.mailofly.com/v1 \
  -H "Accept: application/json"
```

***

## 2. Send an email

```bash theme={null}
curl -X POST https://api.mailofly.com/v1/emails \
  -H "Authorization: Bearer $MAILOFLY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "from": "Acme <onboarding@example.com>",
    "to": ["you@example.com"],
    "subject": "Hello from Mailofly",
    "html": "<p>It works!</p>"
  }'
```

Response: `{ "id": "mail-log-uuid" }`

***

## 3. Send a batch (up to 100 emails)

```bash theme={null}
curl -X POST https://api.mailofly.com/v1/emails/batch \
  -H "Authorization: Bearer $MAILOFLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[
    {"from":"Acme <onboarding@example.com>","to":["foo@example.com"],"subject":"hello","html":"<p>1</p>"},
    {"from":"Acme <onboarding@example.com>","to":["bar@example.com"],"subject":"hello","html":"<p>2</p>"}
  ]'
```

Response: `{ "data": [{ "id": "…" }, …] }`

***

## 4. List mail logs

```bash theme={null}
curl "https://api.mailofly.com/v1/mail-logs?page=1&page_size=10" \
  -H "Authorization: Bearer $MAILOFLY_API_KEY" \
  -H "Accept: application/json"
```

***

## Next

* [Sending examples](sending-examples.md)
* [Emails API](https://docs.mailofly.com/api/emails)
* [SDKs](../sdks/README.md) — typed clients for Node, Python, PHP, Go, Dart


## Related topics

- [Introduction](/api/index.md)
- [Create Webhook](/api/webhooks/create-webhook.md)