# All endpoints

> Every Emailit API v2 endpoint in one place, grouped by resource, with its HTTP method, path, the API key scope it needs and a link to its reference.

This page lists every endpoint of the Emailit API, grouped by resource. Paths are relative to the base URL `https://api.emailit.com/v2`, and `{id}` stands for the ID of the object (or, where the endpoint allows it, its name or email address).

The **Scope** column shows which [API keys](/docs/api-reference/authentication/#scopes) can call the endpoint:

| Scope | Works with |
| --- | --- |
| `sending` | Keys with the `sending` or the `full` scope. |
| `full` | Keys with the `full` scope only. |

OAuth access tokens follow the same rules as API keys with the same scope.

## Emails

Send email, look up messages and their content, and schedule, cancel, retry or forward them. See [Emails](/docs/api-reference/emails/) for the full reference.

| Endpoint | Method | Path | Scope |
| --- | --- | --- | --- |
| [Send an email](/docs/api-reference/emails/send/) | `POST` | `/emails` | `sending` |
| [List emails](/docs/api-reference/emails/list/) | `GET` | `/emails` | `full` |
| [Retrieve an email](/docs/api-reference/emails/get/) | `GET` | `/emails/{id}` | `full` |
| [Retrieve raw MIME](/docs/api-reference/emails/raw/) | `GET` | `/emails/{id}/raw` | `full` |
| [List attachments](/docs/api-reference/emails/attachments/) | `GET` | `/emails/{id}/attachments` | `full` |
| [Retrieve the body](/docs/api-reference/emails/body/) | `GET` | `/emails/{id}/body` | `full` |
| [Retrieve metadata](/docs/api-reference/emails/meta/) | `GET` | `/emails/{id}/meta` | `full` |
| [Update a scheduled email](/docs/api-reference/emails/update/) | `POST` | `/emails/{id}` | `sending` |
| [Cancel an email](/docs/api-reference/emails/cancel/) | `POST` | `/emails/{id}/cancel` | `sending` |
| [Retry an email](/docs/api-reference/emails/retry/) | `POST` | `/emails/{id}/retry` | `sending` |
| [Forward an email](/docs/api-reference/emails/forward/) | `POST` | `/emails/{id}/forward` | `sending` |
| [Retrieve status only](/docs/api-reference/emails/status/) | `GET` | `/email/{id}` | `full` |

## Domains

Add sending domains, read their DNS records and verification status, and verify them. See [Domains](/docs/api-reference/domains/) for the full reference.

| Endpoint | Method | Path | Scope |
| --- | --- | --- | --- |
| [Create a domain](/docs/api-reference/domains/create/) | `POST` | `/domains` | `full` |
| [Retrieve a domain](/docs/api-reference/domains/get/) | `GET` | `/domains/{id}` | `full` |
| [Verify a domain](/docs/api-reference/domains/verify/) | `POST` | `/domains/{id}/verify` | `full` |
| [Update a domain](/docs/api-reference/domains/update/) | `POST` | `/domains/{id}` | `full` |
| [List domains](/docs/api-reference/domains/list/) | `GET` | `/domains` | `full` |
| [Delete a domain](/docs/api-reference/domains/delete/) | `DELETE` | `/domains/{id}` | `full` |

## DMARC reports

Read aggregate and forensic DMARC reports for a sending domain, or upload your own. See [DMARC reports](/docs/api-reference/dmarc/) for the full reference.

| Endpoint | Method | Path | Scope |
| --- | --- | --- | --- |
| [List aggregate reports](/docs/api-reference/dmarc/list/) | `GET` | `/domains/{id}/dmarc/reports` | `full` |
| [Retrieve a report](/docs/api-reference/dmarc/get/) | `GET` | `/domains/{id}/dmarc/reports/{report_id}` | `full` |
| [Upload a report](/docs/api-reference/dmarc/upload/) | `POST` | `/domains/{id}/dmarc/reports` | `full` |
| [List forensic reports](/docs/api-reference/dmarc/forensic/) | `GET` | `/domains/{id}/dmarc/forensic` | `full` |
| [Retrieve a forensic report](/docs/api-reference/dmarc/forensic-get/) | `GET` | `/domains/{id}/dmarc/forensic/{report_id}` | `full` |
| [Retrieve statistics](/docs/api-reference/dmarc/stats/) | `GET` | `/domains/{id}/dmarc/stats` | `full` |
| [List sending sources](/docs/api-reference/dmarc/sources/) | `GET` | `/domains/{id}/dmarc/sources` | `full` |
| [List countries](/docs/api-reference/dmarc/countries/) | `GET` | `/domains/{id}/dmarc/countries` | `full` |
| [List networks (ASNs)](/docs/api-reference/dmarc/asns/) | `GET` | `/domains/{id}/dmarc/asns` | `full` |
| [List reporters](/docs/api-reference/dmarc/reporters/) | `GET` | `/domains/{id}/dmarc/reporters` | `full` |

## API keys

Create, list, rename and revoke the API keys of a workspace. See [API keys](/docs/api-reference/api-keys/) for the full reference.

| Endpoint | Method | Path | Scope |
| --- | --- | --- | --- |
| [Create an API key](/docs/api-reference/api-keys/create/) | `POST` | `/api-keys` | `full` |
| [Retrieve an API key](/docs/api-reference/api-keys/get/) | `GET` | `/api-keys/{id}` | `full` |
| [List API keys](/docs/api-reference/api-keys/list/) | `GET` | `/api-keys` | `full` |
| [Update an API key](/docs/api-reference/api-keys/update/) | `POST` | `/api-keys/{id}` | `full` |
| [Regenerate an API key](/docs/api-reference/api-keys/regenerate/) | `POST` | `/api-keys/{id}/regenerate` | `full` |
| [Delete an API key](/docs/api-reference/api-keys/delete/) | `DELETE` | `/api-keys/{id}` | `full` |

## Audiences

Manage subscriber lists used by campaigns and sign-up forms. See [Audiences](/docs/api-reference/audiences/) for the full reference.

| Endpoint | Method | Path | Scope |
| --- | --- | --- | --- |
| [Create an audience](/docs/api-reference/audiences/create/) | `POST` | `/audiences` | `full` |
| [Retrieve an audience](/docs/api-reference/audiences/get/) | `GET` | `/audiences/{id}` | `full` |
| [Update an audience](/docs/api-reference/audiences/update/) | `POST` | `/audiences/{id}` | `full` |
| [List audiences](/docs/api-reference/audiences/list/) | `GET` | `/audiences` | `full` |
| [Delete an audience](/docs/api-reference/audiences/delete/) | `DELETE` | `/audiences/{id}` | `full` |

## Subscribers

Add, update and remove the subscribers of an audience. See [Subscribers](/docs/api-reference/audiences/subscribers/) for the full reference.

| Endpoint | Method | Path | Scope |
| --- | --- | --- | --- |
| [Add a subscriber](/docs/api-reference/audiences/subscribers/add/) | `POST` | `/audiences/{audience_id}/subscribers` | `full` |
| [Retrieve a subscriber](/docs/api-reference/audiences/subscribers/get/) | `GET` | `/audiences/{audience_id}/subscribers/{id}` | `full` |
| [Update a subscriber](/docs/api-reference/audiences/subscribers/update/) | `POST` | `/audiences/{audience_id}/subscribers/{id}` | `full` |
| [List subscribers](/docs/api-reference/audiences/subscribers/list/) | `GET` | `/audiences/{audience_id}/subscribers` | `full` |
| [Delete a subscriber](/docs/api-reference/audiences/subscribers/delete/) | `DELETE` | `/audiences/{audience_id}/subscribers/{id}` | `full` |

## Contacts

Manage contact profiles and custom fields, in bulk or one at a time. See [Contacts](/docs/api-reference/contacts/) for the full reference.

| Endpoint | Method | Path | Scope |
| --- | --- | --- | --- |
| [Create a contact](/docs/api-reference/contacts/create/) | `POST` | `/contacts` | `full` |
| [Retrieve a contact](/docs/api-reference/contacts/get/) | `GET` | `/contacts/{id}` | `full` |
| [Update a contact](/docs/api-reference/contacts/update/) | `POST` | `/contacts/{id}` | `full` |
| [List contacts](/docs/api-reference/contacts/list/) | `GET` | `/contacts` | `full` |
| [Bulk update contacts](/docs/api-reference/contacts/bulk/) | `POST` | `/contacts/bulk` | `full` |
| [Export contacts](/docs/api-reference/contacts/export/) | `GET`, `POST` | `/contacts/export` | `full` |
| [Delete a contact](/docs/api-reference/contacts/delete/) | `DELETE` | `/contacts/{id}` | `full` |

## Campaigns

Create campaigns, choose their audiences, and send or schedule them. See [Campaigns](/docs/api-reference/campaigns/) for the full reference.

| Endpoint | Method | Path | Scope |
| --- | --- | --- | --- |
| [Create a campaign](/docs/api-reference/campaigns/create/) | `POST` | `/campaigns` | `full` |
| [Retrieve a campaign](/docs/api-reference/campaigns/get/) | `GET` | `/campaigns/{id}` | `full` |
| [Update a campaign](/docs/api-reference/campaigns/update/) | `POST` | `/campaigns/{id}` | `full` |
| [List campaigns](/docs/api-reference/campaigns/list/) | `GET` | `/campaigns` | `full` |
| [Send or schedule a campaign](/docs/api-reference/campaigns/send/) | `POST` | `/campaigns/{id}/send` | `full` |
| [Cancel a campaign](/docs/api-reference/campaigns/cancel/) | `POST` | `/campaigns/{id}/cancel` | `full` |
| [Delete a campaign](/docs/api-reference/campaigns/delete/) | `DELETE` | `/campaigns/{id}` | `full` |

## Automations

Build workflows from triggers and steps, run them, and inspect their runs. See [Automations](/docs/api-reference/automations/) for the full reference.

| Endpoint | Method | Path | Scope |
| --- | --- | --- | --- |
| [Create an automation](/docs/api-reference/automations/create/) | `POST` | `/automations` | `full` |
| [Retrieve an automation](/docs/api-reference/automations/get/) | `GET` | `/automations/{id}` | `full` |
| [Update an automation](/docs/api-reference/automations/update/) | `POST` | `/automations/{id}` | `full` |
| [List automations](/docs/api-reference/automations/list/) | `GET` | `/automations` | `full` |
| [Delete an automation](/docs/api-reference/automations/delete/) | `DELETE` | `/automations/{id}` | `full` |
| [Start an automation](/docs/api-reference/automations/start/) | `POST` | `/automations/{id}/start` | `full` |
| [Pause an automation](/docs/api-reference/automations/pause/) | `POST` | `/automations/{id}/pause` | `full` |
| [Stop an automation](/docs/api-reference/automations/stop/) | `POST` | `/automations/{id}/stop` | `full` |
| [Trigger a run](/docs/api-reference/automations/trigger/) | `POST` | `/automations/{id}/trigger` | `full` |
| [List runs](/docs/api-reference/automations/runs/) | `GET` | `/automations/{id}/runs` | `full` |
| [Retrieve a run](/docs/api-reference/automations/run/) | `GET` | `/automations/{id}/runs/{run_id}` | `full` |
| [Retrieve statistics](/docs/api-reference/automations/stats/) | `GET` | `/automations/{id}/stats` | `full` |
| [Retrieve step statistics](/docs/api-reference/automations/step-stats/) | `GET` | `/automations/{id}/steps/{step_key}/stats` | `full` |

## Forms

Create sign-up forms, publish them, and rotate their public token. See [Forms](/docs/api-reference/forms/) for the full reference.

| Endpoint | Method | Path | Scope |
| --- | --- | --- | --- |
| [Create a form](/docs/api-reference/forms/create/) | `POST` | `/forms` | `full` |
| [Retrieve a form](/docs/api-reference/forms/get/) | `GET` | `/forms/{id}` | `full` |
| [Update a form](/docs/api-reference/forms/update/) | `POST` | `/forms/{id}` | `full` |
| [List forms](/docs/api-reference/forms/list/) | `GET` | `/forms` | `full` |
| [Publish a form](/docs/api-reference/forms/publish/) | `POST` | `/forms/{id}/publish` | `full` |
| [Unpublish a form](/docs/api-reference/forms/unpublish/) | `POST` | `/forms/{id}/unpublish` | `full` |
| [Reset the public token](/docs/api-reference/forms/reset-token/) | `POST` | `/forms/{id}/reset-token` | `full` |
| [Delete a form](/docs/api-reference/forms/delete/) | `DELETE` | `/forms/{id}` | `full` |

## Templates

Create template versions, publish one per alias, and use them when sending. See [Templates](/docs/api-reference/templates/) for the full reference.

| Endpoint | Method | Path | Scope |
| --- | --- | --- | --- |
| [Create a template](/docs/api-reference/templates/create/) | `POST` | `/templates` | `full` |
| [Retrieve a template](/docs/api-reference/templates/get/) | `GET` | `/templates/{id}` | `full` |
| [Update a template](/docs/api-reference/templates/update/) | `POST` | `/templates/{id}` | `full` |
| [List templates](/docs/api-reference/templates/list/) | `GET` | `/templates` | `full` |
| [Publish a template](/docs/api-reference/templates/publish/) | `POST` | `/templates/{id}/publish` | `full` |
| [Delete a template](/docs/api-reference/templates/delete/) | `DELETE` | `/templates/{id}` | `full` |

## Suppressions

Read and manage the addresses Emailit will not send to. See [Suppressions](/docs/api-reference/suppressions/) for the full reference.

| Endpoint | Method | Path | Scope |
| --- | --- | --- | --- |
| [Create a suppression](/docs/api-reference/suppressions/create/) | `POST` | `/suppressions` | `full` |
| [Retrieve a suppression](/docs/api-reference/suppressions/get/) | `GET` | `/suppressions/{id}` | `full` |
| [Update a suppression](/docs/api-reference/suppressions/update/) | `POST` | `/suppressions/{id}` | `full` |
| [List suppressions](/docs/api-reference/suppressions/list/) | `GET` | `/suppressions` | `full` |
| [Delete a suppression](/docs/api-reference/suppressions/delete/) | `DELETE` | `/suppressions/{id}` | `full` |

## Webhooks

Register endpoints that receive signed event notifications. See [Webhooks](/docs/api-reference/webhooks/) for the full reference.

| Endpoint | Method | Path | Scope |
| --- | --- | --- | --- |
| [Create a webhook](/docs/api-reference/webhooks/create/) | `POST` | `/webhooks` | `full` |
| [Retrieve a webhook](/docs/api-reference/webhooks/get/) | `GET` | `/webhooks/{id}` | `full` |
| [Update a webhook](/docs/api-reference/webhooks/update/) | `POST` | `/webhooks/{id}` | `full` |
| [List webhooks](/docs/api-reference/webhooks/list/) | `GET` | `/webhooks` | `full` |
| [Delete a webhook](/docs/api-reference/webhooks/delete/) | `DELETE` | `/webhooks/{id}` | `full` |
| [Send a test event](/docs/api-reference/webhooks/test/) | `POST` | `/webhooks/{id}/test` | `full` |
| [Rotate the signing secret](/docs/api-reference/webhooks/reset-secret/) | `POST` | `/webhooks/{id}/reset-secret` | `full` |
| [Retry failed requests](/docs/api-reference/webhooks/retry-failed/) | `POST` | `/webhooks/{id}/retry-failed` | `full` |
| [Retry one request](/docs/api-reference/webhooks/retry-request/) | `POST` | `/webhooks/{id}/requests/{request_id}/retry` | `full` |

## Events

Read the event stream behind webhooks: deliveries, bounces, opens and more. See [Events](/docs/api-reference/events/) for the full reference.

| Endpoint | Method | Path | Scope |
| --- | --- | --- | --- |
| [List events](/docs/api-reference/events/list/) | `GET` | `/events` | `full` |
| [Retrieve an event](/docs/api-reference/events/get/) | `GET` | `/events/{id}` | `full` |

## Email verification

Verify a single address in real time. See [Email verification](/docs/api-reference/email-verifications/) for the full reference.

| Endpoint | Method | Path | Scope |
| --- | --- | --- | --- |
| [Verify an address](/docs/api-reference/email-verifications/verify/) | `POST` | `/email-verifications` | `full` |

## Verification lists

Verify up to 10,000 addresses at once and export the results. See [Verification lists](/docs/api-reference/email-verifications/lists/) for the full reference.

| Endpoint | Method | Path | Scope |
| --- | --- | --- | --- |
| [Create a list](/docs/api-reference/email-verifications/lists/create/) | `POST` | `/email-verification-lists` | `full` |
| [List lists](/docs/api-reference/email-verifications/lists/list/) | `GET` | `/email-verification-lists` | `full` |
| [Retrieve a list](/docs/api-reference/email-verifications/lists/get/) | `GET` | `/email-verification-lists/{id}` | `full` |
| [List results](/docs/api-reference/email-verifications/lists/results/) | `GET` | `/email-verification-lists/{id}/results` | `full` |
| [Export results](/docs/api-reference/email-verifications/lists/export/) | `GET` | `/email-verification-lists/{id}/export` | `full` |

---
Source: https://emailit.com/docs/api-reference/endpoints/