**⚠️ Legacy Notice**

This version of the API (v1) is now considered legacy and is no longer actively maintained. We recommend migrating to [API v2](/content/api-documentation/v2 "API v2"/index.html) for new features, improvements, and ongoing support.

Use our API to give an application or website permission to interact with your EmailOctopus account.

## Requests

- All requests require a valid API key.
- Requests should be made using HTTPS.
- JSON objects are recommended for POST requests, but form parameters are also accepted.
- If you're making a JSON request, include a `Content-Type: application/json` header.
- All parameters are required unless otherwise specified.

## Response

- Data returned in JSON.
- Any non-200 HTTP response code can be considered an error.

## Methods

[Automations](/content/api-documentation/automations/index.html)

- [Start automation](/content/api-documentation/automations/queue/index.html)

[Campaigns](/content/api-documentation/campaigns/index.html)

- [Get campaign](/content/api-documentation/campaigns/get/index.html)
- [Get all campaigns](/content/api-documentation/campaigns/get-all/index.html)

- [Get campaign report: summary](/content/api-documentation/campaigns/report/get-summary/index.html)
- [Get campaign report: links](/content/api-documentation/campaigns/report/get-links/index.html)
- [Get campaign report: bounced](/content/api-documentation/campaigns/report/get-bounced/index.html)
- [Get campaign report: clicked](/content/api-documentation/campaigns/report/get-clicked/index.html)
- [Get campaign report: complained](/content/api-documentation/campaigns/report/get-complained/index.html)
- [Get campaign report: opened](/content/api-documentation/campaigns/report/get-opened/index.html)
- [Get campaign report: sent](/content/api-documentation/campaigns/report/get-sent/index.html)
- [Get campaign report: unsubscribed](/content/api-documentation/campaigns/report/get-unsubscribed/index.html)
- [Get campaign report: not clicked](/content/api-documentation/campaigns/report/get-not-clicked/index.html)
- [Get campaign report: not opened](/content/api-documentation/campaigns/report/get-not-opened/index.html)

[Lists](/content/api-documentation/lists/index.html)

- [Get list](/content/api-documentation/lists/get/index.html)
- [Get all lists](/content/api-documentation/lists/get-all/index.html)
- [Create list](/content/api-documentation/lists/create/index.html)
- [Update list](/content/api-documentation/lists/update/index.html)
- [Delete list](/content/api-documentation/lists/delete/index.html)
- [Get all tags on list](/content/api-documentation/lists/get-all-tags/index.html)

- [Get contact of list](/content/api-documentation/lists/get-contact/index.html)
- [Get all contacts of list](/content/api-documentation/lists/get-all-contacts/index.html)
- [Get subscribed contacts of list](/content/api-documentation/lists/get-subscribed-contacts/index.html)
- [Get unsubscribed contacts of list](/content/api-documentation/lists/get-unsubscribed-contacts/index.html)
- [Get contacts of list by tag](/content/api-documentation/lists/get-tagged/index.html)
- [Create contact of list](/content/api-documentation/lists/create-contact/index.html)
- [Update contact of list](/content/api-documentation/lists/update-contact/index.html)
- [Delete contact of list](/content/api-documentation/lists/delete-contact/index.html)
- [Update multiple contacts of list](/content/api-documentation/lists/update-contact-bulk/index.html)

- [Create list field](/content/api-documentation/lists/create-field/index.html)
- [Update list field](/content/api-documentation/lists/update-field/index.html)
- [Delete list field](/content/api-documentation/lists/delete-field/index.html)

- [Create list tag](/content/api-documentation/lists/create-tag/index.html)
- [Update list tag](/content/api-documentation/lists/update-tag/index.html)
- [Delete list tag](/content/api-documentation/lists/delete-tag/index.html)