---
title: "Remove User from Team"
method: POST
path: "/team/remove_member"
tags: ["Team"]
---

# Remove User from Team

`POST /team/remove_member`

Removes the provided user Account from your Team. If the Account had an outstanding invitation to your Team, the invitation will be expired. If you choose to transfer documents from the removed Account to an Account provided in the `new_owner_email_address` parameter (available only for Enterprise plans), the response status code will be 201, which indicates that your request has been queued but not fully executed.

## Request body

- TeamRemoveMemberRequest
  - `account_id` string — **account_id** or **email_address** is required. If both are provided, the account id prevails. Account id to remove from your Team.
  - `email_address` string, email — **account_id** or **email_address** is required. If both are provided, the account id prevails. Email address of the Account to remove from your Team.
  - `new_owner_email_address` string, email — The email address of an Account on this Team to receive all documents, templates, and API apps (if applicable) from the removed Account. If not provided, and on an Enterprise plan, this data will remain with the removed Account. **NOTE:** Only available for Enterprise plans.
  - `new_team_id` string — Id of the new Team.
  - `new_role` 'Member' | 'Developer' | 'Team Manager' | 'Admin' — A new role member will take in a new Team. **NOTE:** This parameter is used only if `new_team_id` is provided.

## Response `201`

successful operation

- TeamGetResponse
  - `team` TeamResponse, required — Contains information about your team and its members
    - `name` string — The name of your Team
    - `accounts` AccountResponse[]
      - `account_id` string — The ID of the Account
      - `email_address` string — The email address associated with the Account.
      - `is_locked` boolean — Returns `true` if the user has been locked out of their account by a team admin.
      - `is_paid_hs` boolean — Returns `true` if the user has a paid Dropbox Sign account.
      - `is_paid_hf` boolean — Returns `true` if the user has a paid HelloFax account.
      - `quotas` AccountResponseQuotas — Details concerning remaining monthly quotas.
        - `api_signature_requests_left` integer, nullable — API signature requests remaining.
        - `documents_left` integer, nullable — Signature requests remaining.
        - `templates_total` integer, nullable — Total API templates allowed.
        - `templates_left` integer, nullable — API templates remaining.
        - `sms_verifications_left` integer, nullable — SMS verifications remaining.
        - `num_fax_pages_left` integer, nullable — Number of fax pages left
      - `callback_url` string, nullable — The URL that Dropbox Sign events will `POST` to.
      - `role_code` string, nullable — The membership role for the team.
      - `team_id` string, nullable — The id of the team account belongs to.
      - `locale` string, nullable — The locale used in this Account. Check out the list of [supported locales](/api/reference/constants/#supported-locales) to learn more about the possible values.
      - `usage` AccountResponseUsage — Details concerning monthly usage
        - `fax_pages_sent` integer, nullable — Number of fax pages sent
      - `settings` AccountResponseSettings — Subset of configured settings
        - `signer_access_codes` boolean — Returns `true` if _Custom access codes_ is enabled in Admin Console. [Read more](https://developers.hellosign.com/docs/sms-tools/walkthrough).
        - `sms_delivery` boolean — Returns `true` if _Text message_ is enabled in Admin Console. [Read more](https://developers.hellosign.com/docs/sms-tools/walkthrough).
        - `sms_authentication` boolean — Returns `true` if _Signer authentication_ is enabled in Admin Console. [Read more](https://developers.hellosign.com/docs/sms-tools/walkthrough).
    - `invited_accounts` AccountResponse[] — A list of all Accounts that have an outstanding invitation to join your Team. Note that this response is a subset of the response parameters found in `GET /account`.
      - `account_id` string — The ID of the Account
      - `email_address` string — The email address associated with the Account.
      - `is_locked` boolean — Returns `true` if the user has been locked out of their account by a team admin.
      - `is_paid_hs` boolean — Returns `true` if the user has a paid Dropbox Sign account.
      - `is_paid_hf` boolean — Returns `true` if the user has a paid HelloFax account.
      - `quotas` AccountResponseQuotas — Details concerning remaining monthly quotas.
        - `api_signature_requests_left` integer, nullable — API signature requests remaining.
        - `documents_left` integer, nullable — Signature requests remaining.
        - `templates_total` integer, nullable — Total API templates allowed.
        - `templates_left` integer, nullable — API templates remaining.
        - `sms_verifications_left` integer, nullable — SMS verifications remaining.
        - `num_fax_pages_left` integer, nullable — Number of fax pages left
      - `callback_url` string, nullable — The URL that Dropbox Sign events will `POST` to.
      - `role_code` string, nullable — The membership role for the team.
      - `team_id` string, nullable — The id of the team account belongs to.
      - `locale` string, nullable — The locale used in this Account. Check out the list of [supported locales](/api/reference/constants/#supported-locales) to learn more about the possible values.
      - `usage` AccountResponseUsage — Details concerning monthly usage
        - `fax_pages_sent` integer, nullable — Number of fax pages sent
      - `settings` AccountResponseSettings — Subset of configured settings
        - `signer_access_codes` boolean — Returns `true` if _Custom access codes_ is enabled in Admin Console. [Read more](https://developers.hellosign.com/docs/sms-tools/walkthrough).
        - `sms_delivery` boolean — Returns `true` if _Text message_ is enabled in Admin Console. [Read more](https://developers.hellosign.com/docs/sms-tools/walkthrough).
        - `sms_authentication` boolean — Returns `true` if _Signer authentication_ is enabled in Admin Console. [Read more](https://developers.hellosign.com/docs/sms-tools/walkthrough).
    - `invited_emails` string[] — A list of email addresses that have an outstanding invitation to join your Team and do not yet have a Dropbox Sign account.
  - `warnings` WarningResponse[] — A list of warnings.
    - `warning_msg` string, required — Warning message
    - `warning_name` string, required — Warning name

## Other responses

- `4XX` — failed_operation

---

[API](https://skmtc.net/hellosign/apis/dropbox-sign-api.md) · [All operations](https://skmtc.net/hellosign/apis/dropbox-sign-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hellosign/dropbox-sign-api/versions/2ea3f04008af/schema)