Members Secondary Emails Add

POST

https://api.dropboxapi.com/2/team/members/secondary_emails/add

POST

/2/team/members/secondary_emails/add

import requests
url = "https://api.dropboxapi.com/2/team/members/secondary_emails/add"
payload = { "new_secondary_emails": [
        {
            "secondary_emails": ["bob2@hotmail.com", "bob@inst.gov"],
            "user": {
                ".tag": "team_member_id",
                "team_member_id": "dbmid:efgh5678"
            }
        }
    ] }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

Response headers

HTTP/1.1 200 OK
X-Dropbox-Request-Id: string

{
  "results": [
    {
      ".tag": "success",
      "results": [
        {
          ".tag": "success",
          "email": "apple@orange.com",
          "is_verified": true
        },
        {
          ".tag": "unavailable",
          "unavailable": "alice@example.com"
        }
      ],
      "user": {
        ".tag": "team_member_id",
        "team_member_id": "dbmid:efgh5678"
      }
    },
    {
      ".tag": "invalid_user",
      "invalid_user": {
        ".tag": "team_member_id",
        "team_member_id": "dbmid:efgh5678"
      }
    }
  ]
}

Add secondary emails to users.

Permission : Team member management.

Emails that are on verified domains will be verified automatically. For each email address not on a verified domain a verification email will be sent.

Required scope: members.write

Endpoint format: RPC

Authentication: Team

Authentication

AuthorizationBearer

Team-level OAuth 2.0 token issued to a Dropbox Business admin. Use Authorization: Bearer <token>.

Obtain via the authorization code flow with team-scoped permissions.

Grants access to team-wide administrative operations.

You can generate a short-lived access token from the App Console; see Testing with a generated token.

Request

This endpoint expects an object.

new_secondary_emailslist of objectsRequired

List of users and secondary emails to add.

Response headers

X-Dropbox-Request-IdstringOptional

A unique identifier for the request, useful for debugging and support.

Response

Successful response

resultslist of objects

List of users and secondary email results.

Variant:

team_apiv2.UserAddResult.successobject

Describes a user and the results for each attempt to add a secondary email.

Errors

401

Unauthorized Error

403

Forbidden Error

409

Conflict Error

429

Too Many Requests Error

500

Internal Server Error