# flomailr API

**Canonical:** https://apis.io/apis/flomailr-com/flomailr-com-api/  
**Provider:** flomailr — https://apis.io/providers/flomailr-com/  
**Documentation:** https://flomailr.com/docs/api/send

flomailr API is published by [flomailr](https://apis.io/providers/flomailr-com/) on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

flomailr API as documented publicly: 31 operations. Contract generated from the documentation by API Evangelist (2026-11-08); not the provider's own document.

## Operations (31)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/contacts` | List contacts |
| POST | `/api/v1/contacts` | POST /api/v1/contacts |
| DELETE | `/api/v1/contacts/{id}` | Delete a contact |
| GET | `/api/v1/contacts/{id}` | Get a contact |
| PATCH | `/api/v1/contacts/{id}` | Update a contact |
| GET | `/api/v1/contacts/{id}/lists` | Lists a contact is on |
| GET | `/api/v1/events` | List events |
| POST | `/api/v1/events` | Record an event |
| GET | `/api/v1/forms` | List forms |
| POST | `/api/v1/forms` | Create a form |
| DELETE | `/api/v1/forms/{id}` | Delete a form |
| GET | `/api/v1/forms/{id}` | Get a form |
| PATCH | `/api/v1/forms/{id}` | Update a form |
| GET | `/api/v1/keys` | List keys |
| POST | `/api/v1/keys` | Create a key |
| DELETE | `/api/v1/keys/{id}` | Revoke a key |
| GET | `/api/v1/keys/{id}` | Get a key |
| GET | `/api/v1/lists` | List your lists |
| POST | `/api/v1/lists` | Create a list |
| DELETE | `/api/v1/lists/{id}` | Get, rename and delete a list |
| GET | `/api/v1/lists/{id}` | Get, rename and delete a list |
| PATCH | `/api/v1/lists/{id}` | Get, rename and delete a list |
| GET | `/api/v1/lists/{id}/contacts` | List the contacts on a list |
| POST | `/api/v1/lists/{id}/contacts` | Add contacts to a list |
| DELETE | `/api/v1/lists/{id}/contacts/{contactid}` | Remove a contact from a list |
| POST | `/api/v1/send` | POST /api/v1/send |
| POST | `/campaigns/{id}/send` | POST /campaigns/{id}/send and POST /send email real people and cannot be undone. |
| POST | `/contacts` | POST /contacts creates a new address as SUBSCRIBED unless you send status: "PENDING", which is you saying the person agreed to marketing email. |
| POST | `/events` | POST /events always creates unknown addresses as PENDING. |
| GET | `/openapi.json` | GET /openapi.json |
| POST | `/send` | POST /send email real people and cannot be undone. |

## Machine-readable artifacts (8)

- **OpenAPI** — https://artifacts.apis.io/flomailr-com/openapi/_ae-authored/flomailr-com-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/flomailr-com/json-schema/flomailr-com-post-api-v1-events-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/flomailr-com/json-schema/flomailr-com-get-api-v1-events-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/flomailr-com/json-schema/flomailr-com-get-api-v1-keys-id-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/flomailr-com/json-schema/flomailr-com-get-api-v1-keys-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/flomailr-com/json-schema/flomailr-com-patch-api-v1-forms-id-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/flomailr-com/json-schema/flomailr-com-get-api-v1-lists-id-response-schema.json
- **APIsJSON** — https://artifacts.apis.io/flomailr-com/apis.yml

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/flomailr-com/flomailr-com-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/flomailr-com/.