---
title: "Add User to Team"
method: PUT
path: "/team/add_member"
tags: ["Team"]
---

# Add User to Team

`PUT /team/add_member`

Invites a user (specified using the `email_address` parameter) to your Team. If the user does not currently have a Dropbox Sign Account, a new one will be created for them. If a user is already a part of another Team, a `team_invite_failed` error will be returned.

## Query parameters

- `team_id` string

## Request body

- TeamAddMemberRequest
  - `account_id` string — `account_id` or `email_address` is required. If both are provided, the account id prevails. Account id of the user to invite to 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 user to invite to your Team.
  - `role` 'Member' | 'Developer' | 'Team Manager' | 'Admin' — A role member will take in a new Team. **NOTE:** This parameter is used only if `team_id` is provided.

## Response `200`

successful operation

- TeamGetResponse
  - `team` TeamResponse, required — Contains information about your team and its members
    - `name` string, required — The name of your Team
    - `accounts` AccountResponse[], required
      - `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
    - `invited_accounts` AccountResponse[], required — 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
    - `invited_emails` string[], required — 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

## Changes

- **2024-10-15** `26fa0d3b7b9b` — 4 info
  - the response property `team/accounts` became required for the status `200`
  - the response property `team/invited_accounts` became required for the status `200`
  - the response property `team/invited_emails` became required for the status `200`
  - the response property `team/name` became required for the status `200`
- **2024-09-04** `8d8f5e2e9401` — 1 info
  - the response property `team` became required for the status `200`
- **2024-08-22** `e9603b26e6f8` — 1 breaking, 2 warning
  - the response property `team` became optional for the status `200`
  - removed the optional property `team/accounts/items/settings` from the response with the `200` status
  - removed the optional property `team/invited_accounts/items/settings` from the response with the `200` status

[Change history](https://skmtc.dev/hellosign/apis/dropbox-sign-api/changes/team/add_member/put.md)

---

[API](https://skmtc.dev/hellosign/apis/dropbox-sign-api.md) · [All operations](https://skmtc.dev/hellosign/apis/dropbox-sign-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hellosign/dropbox-sign-api/revisions/d21a4e6ba2e9/schema)