---
title: "Cancel dfy email accounts"
method: POST
path: "/api/v2/dfy-email-account-orders/accounts/cancel"
tags: ["DFYEmailAccountOrder"]
---

# Cancel dfy email accounts

`POST /api/v2/dfy-email-account-orders/accounts/cancel`

This endpoint will cancel the DFY email accounts based on the provided email addresses. Cancelling permanently deletes all Unibox emails and conversations associated with the cancelled accounts. This cannot be undone.


Requires one of the following scopes: `dfy_email_account_orders:delete`, `dfy_email_account_orders:all`, `all:delete`, `all:all`

## Request body

- object
  - `accounts` string[], required — List of emails to cancel the DFY email accounts for.

## Response `200`

Default Response

- object
  - `items` object[], required — The list of cancelled email accounts.
    - `id` string, required — The unique identifier of the email account order
    - `domain` string, required — The domain associated with the email account
    - `email` string, required — The email address of the account
    - `email_provider` 1 | 2 | 3, required — The mailbox product to order. Defaults to Google when omitted. Options: - 1: Google. Up to 5 mailboxes per domain; priced per mailbox monthly. - 2: AirMail. Up to 5 mailboxes per domain; priced per mailbox monthly. - 3: Microsoft/Outlook. Exactly 50 mailboxes per new DFY domain; priced per domain monthly.
    - `first_name` string, required — The first name of the account
    - `last_name` string, required — The last name of the account
    - `is_pre_warmed_up` boolean, required — Whether the account is pre-warmed up
    - `timestamp_cancelled` string, required — The timestamp when the account was cancelled
    - `timestamp_created` string, required — The timestamp when the account was created

## Other responses

- `401` — This request is unauthorized (either the Authorization header is missing or invalid, or the API key has been revoked)
- `402` — This request cannot be fulfilled because the workspace does not have an active paid plan
- `404` — The requested resource was not found
- `429` — You have exceeded the rate limit. Please check the rate limit docs for more information.

---

[API](https://skmtc.net/instantly/apis/api-explorer.md) · [All operations](https://skmtc.net/instantly/apis/api-explorer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/instantly/api-explorer/versions/378d1e253fe7/schema)