---
title: "Delete an account"
method: DELETE
path: "/accounts/{id}"
tags: ["Accounts (Companies)"]
---

# Delete an account

`DELETE /accounts/{id}`

Delete an account by ID. Deleted accounts are removed from the companies tab, and can be restored from the trash within 30 days of deletion via the undelete endpoint.

## Path parameters

- `id` string, required

## Response `200`

OK

- AccountResponse — A full response object for an account-related endpoint.
  - `meta` Meta — Information about the Nutshell instance making the request
    - `instanceId` string — The Nutshell instance ID
    - `siteId` string — Site ID for WebFX customers
  - `accounts` object[] — An array of returned accounts.
    - `id` string — The API ID of this entity, formatted {integer}-{entityType}
    - `name` string — The entity's full name.
    - `description` string — A brief explanation of this entity which appears under their name.
    - `createdTime` integer — Unix timestamp
    - `deletedTime` integer — Unix timestamp
    - `emails` object[] — All email addresses associated with an entity.
      - `isPrimary` boolean — If entity has multiple email addresses, which should be used as the primary point of contact.
      - `name` string — A label for the email address, e.g. 'work', 'personal', 'support'.
      - `value` string — The email address itself.
    - `addresses` object[] — All addresses associated with an entity.
      - `isPrimary` boolean — Should this address be used if there are multiple
      - `name` string — A label for the address, e.g. 'work', 'home', 'shipping'.
      - `value` object — The geographic coordinates for the address.
        - `location` object
          - `longitude` number
          - `latitude` number
      - `locationAccuracy` string — How specific the address is. 8 is an exact street address, 1 is only a country.
      - `address_1` string — Primary street address
      - `address_2` string — Secondary street address, such as a suite or apartment number
      - `address_3` string
      - `city` string — City or town
      - `state` string — State or province
      - `postalCode` string — ZIP or postal code
      - `country` string — Country code
      - `timezone` string
    - `phones` object[]
      - `isOptedOut` boolean — If this number has opted out of receiving SMS messages
      - `isPrimary` boolean — Should this phone number be used if there are multiple
      - `name` string — A label for the phone number, e.g. 'work', 'home', 'mobile'.
      - `value` object
        - `countryCode` string — Phone number prefix for calling individuals in other countries
        - `number` string — The unformatted phone number with only digits
        - `extension` string — An additional code to reach a specific person or department which share a number
        - `numberFormatted` string — The phone number formatted for human readability
        - `E164` string — The phone number formatted for international use; a common programatic standard for working with phone numbers
        - `countryCodeAndNumber` string — The phone number formatted for human readability with the country code
    - `urls` object[]
      - `isPrimary` boolean — Should this URL be used if there are multiple
      - `name` string — A label for the URL, e.g. 'LinkedIn', 'Facebook', 'personal website'.
      - `value` string — The URL itself
    - `avatarUrl` string — The URL of the entity's avatar image.
    - `initials` string — The initials of the entity, used as a fallback for the avatar image.
    - `htmlUrl` string — The link to the entity within the app.
    - `htmlUrlPath` string — The path to the entity within the app.
    - `href` string
    - `revenue` object
      - `amount` string
      - `formatted` string
    - `employeeCount` integer
  - `creators` User[] — An array of creators for the accounts
    - `avatarUrl` string — The URL of the entity's avatar image.
    - `initials` string — The initials of the entity, used as a fallback for the avatar image.
    - `id` string — The API ID of this entity, formatted {integer}-{entityType}
    - `name` unknown
    - `firstName` unknown
    - `modifiedTime` integer
    - `isEnabled` boolean
    - `hasSetPassword` boolean
    - `isAdministrator` boolean
    - `isViewingRestricted` boolean
    - `isHiddenFromFilters` boolean
    - `canAccessEmailMarketing` boolean
    - `permissions` Permissions
      - `canAccessSetup` boolean
      - `canAccessMarketing` boolean
      - `canBulkEdit` boolean
      - `canExport` boolean
      - `canViewSharedEmails` boolean
      - `canImport` boolean
      - `canMergeEntities` boolean
      - `canDeleteEntities` boolean
      - `canAssignEntities` boolean
      - `canAccessBilling` boolean
      - `canManageEmailTemplates` boolean
      - `canAccessCrm` boolean
      - `canAccessFullCampaigns` boolean
      - `canUsePeopleIQ` boolean
      - `canUseInbox` boolean
    - `emails` string[]
    - `phonecallerType` unknown
  - `owners` User[] — An array of owners for the accounts
    - `avatarUrl` string — The URL of the entity's avatar image.
    - `initials` string — The initials of the entity, used as a fallback for the avatar image.
    - `id` string — The API ID of this entity, formatted {integer}-{entityType}
    - `name` unknown
    - `firstName` unknown
    - `modifiedTime` integer
    - `isEnabled` boolean
    - `hasSetPassword` boolean
    - `isAdministrator` boolean
    - `isViewingRestricted` boolean
    - `isHiddenFromFilters` boolean
    - `canAccessEmailMarketing` boolean
    - `permissions` Permissions
      - `canAccessSetup` boolean
      - `canAccessMarketing` boolean
      - `canBulkEdit` boolean
      - `canExport` boolean
      - `canViewSharedEmails` boolean
      - `canImport` boolean
      - `canMergeEntities` boolean
      - `canDeleteEntities` boolean
      - `canAssignEntities` boolean
      - `canAccessBilling` boolean
      - `canManageEmailTemplates` boolean
      - `canAccessCrm` boolean
      - `canAccessFullCampaigns` boolean
      - `canUsePeopleIQ` boolean
      - `canUseInbox` boolean
    - `emails` string[]
    - `phonecallerType` unknown
  - `origins` object[] — An array of origins for the accounts
    - `avatarUrl` string — The URL of the entity's avatar image.
    - `initials` string — The initials of the entity, used as a fallback for the avatar image.
    - `htmlUrl` string — The link to the entity within the app.
    - `htmlUrlPath` string — The path to the entity within the app.
    - `id` string — The API ID of this entity, formatted {integer}-{entityType}
    - `name` string
    - `modifiedTime` integer
    - `lastseenTime` integer
    - `originType` string
  - `contacts` Contact[] — An array of contacts for the accounts
    - `id` string — The API ID of this entity, formatted {integer}-{entityType}
    - `name` string — The entity's full name.
    - `description` string — A brief explanation of this entity which appears under their name.
    - `createdTime` integer — Unix timestamp
    - `deletedTime` integer — Unix timestamp
    - `emails` object[] — All email addresses associated with an entity.
      - `isPrimary` boolean — If entity has multiple email addresses, which should be used as the primary point of contact.
      - `name` string — A label for the email address, e.g. 'work', 'personal', 'support'.
      - `value` string — The email address itself.
    - `addresses` object[] — All addresses associated with an entity.
      - `isPrimary` boolean — Should this address be used if there are multiple
      - `name` string — A label for the address, e.g. 'work', 'home', 'shipping'.
      - `value` object — The geographic coordinates for the address.
        - `location` object
          - `longitude` number
          - `latitude` number
      - `locationAccuracy` string — How specific the address is. 8 is an exact street address, 1 is only a country.
      - `address_1` string — Primary street address
      - `address_2` string — Secondary street address, such as a suite or apartment number
      - `address_3` string
      - `city` string — City or town
      - `state` string — State or province
      - `postalCode` string — ZIP or postal code
      - `country` string — Country code
      - `timezone` string
    - `phones` object[]
      - `isOptedOut` boolean — If this number has opted out of receiving SMS messages
      - `isPrimary` boolean — Should this phone number be used if there are multiple
      - `name` string — A label for the phone number, e.g. 'work', 'home', 'mobile'.
      - `value` object
        - `countryCode` string — Phone number prefix for calling individuals in other countries
        - `number` string — The unformatted phone number with only digits
        - `extension` string — An additional code to reach a specific person or department which share a number
        - `numberFormatted` string — The phone number formatted for human readability
        - `E164` string — The phone number formatted for international use; a common programatic standard for working with phone numbers
        - `countryCodeAndNumber` string — The phone number formatted for human readability with the country code
    - `urls` object[]
      - `isPrimary` boolean — Should this URL be used if there are multiple
      - `name` string — A label for the URL, e.g. 'LinkedIn', 'Facebook', 'personal website'.
      - `value` string — The URL itself
    - `avatarUrl` string — The URL of the entity's avatar image.
    - `initials` string — The initials of the entity, used as a fallback for the avatar image.
    - `htmlUrl` string — The link to the entity within the app.
    - `htmlUrlPath` string — The path to the entity within the app.
    - `jobTitle` string — The person's role at their company.
    - `firstName` string — The person's given name.
    - `lastName` string — The person's family name.
    - `href` string — The URL to fetch this contact.
  - `accountTypes` AccountType[] — An array of account types for the accounts
    - `id` string — The API ID of this entity, formatted {integer}-{entityType}
    - `name` string
    - `modifiedTime` integer
  - `industries` Industry[] — An array of industries for the accounts
    - `id` string — The API ID of this entity, formatted {integer}-{entityType}
    - `name` string — The type of industry.
    - `modifiedTime` integer

---

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