# Customer.io Emails API

**Canonical:** https://apis.io/apis/customer-io/customer-io-emails-api/  
**Provider:** Customer.io — https://apis.io/providers/customer-io/  
**Base URL:** https://track.customer.io  
**Documentation:** https://docs.customer.io/integrations/api/track/

Customer.io Emails API is one of 48 APIs that [Customer.io](https://apis.io/providers/customer-io/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Email. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 6 JSON Schemas.

Create and manage the emails you build in Design Studio, along with their translations and versions. - **Emails** hold the content, envelope details, and transformers for the default language. - **Translations** are language variants of an email. Each one has its own content and envelope. - **Versions** are named checkpoints of an email's content. Design Studio saves one automatically every time you publish, and you can save, inspect, restore, or delete them yourself. Learn more about the [best practices](/integrations/api/design-studio/integrate/) for sending HTML through these endpoints.

## Operations (15)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/design_studio/emails` | List emails |
| POST | `/v1/design_studio/emails` | Create an email |
| GET | `/v1/design_studio/emails/{id}` | Get an email |
| PUT | `/v1/design_studio/emails/{id}` | Update an email |
| DELETE | `/v1/design_studio/emails/{id}` | Delete an email |
| GET | `/v1/design_studio/emails/{id}/languages` | List email translations |
| POST | `/v1/design_studio/emails/{id}/languages` | Create an email translation |
| GET | `/v1/design_studio/emails/{id}/languages/{language}` | Get an email translation |
| PUT | `/v1/design_studio/emails/{id}/languages/{language}` | Update an email translation |
| DELETE | `/v1/design_studio/emails/{id}/languages/{language}` | Delete an email translation |
| GET | `/v1/design_studio/emails/{id}/versions` | List email versions |
| POST | `/v1/design_studio/emails/{id}/versions` | Save an email version |
| GET | `/v1/design_studio/emails/{id}/versions/{version_id}` | Get an email version |
| DELETE | `/v1/design_studio/emails/{id}/versions/{version_id}` | Delete an email version |
| POST | `/v1/design_studio/emails/{id}/versions/{version_id}/restore` | Restore an email version |

## Machine-readable artifacts (10)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/customer-io/refs/heads/main/openapi/customer-io-emails-api-openapi.yml
- **Documentation** — https://docs.customer.io/integrations/api/app/
- **Documentation** — https://docs.customer.io/integrations/data-in/connections/http-api/
- **Documentation** — https://docs.customer.io/integrations/api/customerio-apis/
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/customer-io/refs/heads/main/json-schema/customer-io-campaign-object-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/customer-io/refs/heads/main/json-schema/customer-io-transformers-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/customer-io/refs/heads/main/json-schema/customer-io-campaign-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/customer-io/refs/heads/main/json-schema/customer-io-newsletter-object-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/customer-io/refs/heads/main/json-schema/customer-io-activity-object-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/customer-io/refs/heads/main/json-schema/customer-io-anonymous-events-request-schema.json

## Other Customer.io APIs (12)

- [Customer.io Track API](https://apis.io/apis/customer-io/track-api/)
- [Customer.io Activities API](https://apis.io/apis/customer-io/customer-io-activities-api/)
- [Customer.io Alias API](https://apis.io/apis/customer-io/customer-io-alias-api/)
- [Customer.io Batch API](https://apis.io/apis/customer-io/customer-io-batch-api/)
- [Customer.io Broadcasts API](https://apis.io/apis/customer-io/customer-io-broadcasts-api/)
- [Customer.io Collections API](https://apis.io/apis/customer-io/customer-io-collections-api/)
- [Customer.io Customers API](https://apis.io/apis/customer-io/customer-io-customers-api/)
- [Customer.io Exports API](https://apis.io/apis/customer-io/customer-io-exports-api/)
- [Customer.io Group API](https://apis.io/apis/customer-io/customer-io-group-api/)
- [Customer.io Identify API](https://apis.io/apis/customer-io/customer-io-identify-api/)
- [Customer.io Messages API](https://apis.io/apis/customer-io/customer-io-messages-api/)
- [Customer.io Newsletters API](https://apis.io/apis/customer-io/customer-io-newsletters-api/)

## Tags

Email

---

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