---
title: "Add a member to teams"
method: POST
path: "/api/v2/members/{id}/teams"
tags: ["Account members"]
---

# Add a member to teams

`POST /api/v2/members/{id}/teams`

Add one member to one or more teams.

## Path parameters

- `id` string, string, required — The member ID

## Request body

- MemberTeamsPostInput
  - `teamKeys` string[], required — List of team keys

## Response `201`

Member response

- Member
  - `_links` object, required — The location and content type of related resources
  - `_id` string, required — The member's ID
  - `firstName` string — The member's first name
  - `lastName` string — The member's last name
  - `role` string, required — The member's base role. If the member has no additional roles, this role will be in effect.
  - `email` string, required — The member's email address
  - `_pendingInvite` boolean, required — Whether the member has a pending invitation
  - `_verified` boolean, required — Whether the member's email address has been verified
  - `_pendingEmail` string — The member's email address before it has been verified, for accounts where email verification is required
  - `customRoles` string[], required — The set of additional roles, besides the base role, assigned to the member
  - `mfa` string, required — Whether multi-factor authentication is enabled for this member
  - `excludedDashboards` string[] — Default dashboards that the member has chosen to ignore
  - `_lastSeen` integer, required
  - `_lastSeenMetadata` LastSeenMetadata
    - `tokenId` string — The ID of the token used in the member's last session
  - `_integrationMetadata` IntegrationMetadata
    - `externalId` string, required
    - `externalStatus` IntegrationStatus, required
      - `display` string, required
      - `value` string, required
    - `externalUrl` string, required
    - `lastChecked` integer, required
  - `teams` MemberTeamSummaryRep[] — Details on the teams this member is assigned to
    - `customRoleKeys` string[], required — A list of keys of the custom roles this team has access to
    - `key` string, required — The team key
    - `_links` object
    - `name` string, required — The team name
  - `permissionGrants` MemberPermissionGrantSummaryRep[] — A list of permission grants. Permission grants allow a member to have access to a specific action, without having to create or update a custom role.
    - `actionSet` string — The name of the group of related actions to allow. A permission grant may have either an <code>actionSet</code> or a list of <code>actions</code> but not both at the same time.
    - `actions` string[] — A list of actions to allow. A permission grant may have either an <code>actionSet</code> or a list of <code>actions</code> but not both at the same time.
    - `resource` string, required — The resource for which the actions are allowed
  - `creationDate` integer, required
  - `oauthProviders` OAuthProviderKind[] — A list of OAuth providers
  - `version` integer — Version of the current configuration
  - `roleAttributes` RoleAttributeMap

## Other responses

- `400` — Invalid request
- `401` — Invalid access token
- `403` — Forbidden
- `404` — Member not found
- `409` — Status conflict
- `429` — Rate limited

---

[API](https://skmtc.dev/launchdarkly/apis/launchdarkly-rest-api.md) · [All operations](https://skmtc.dev/launchdarkly/apis/launchdarkly-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/launchdarkly/launchdarkly-rest-api/revisions/69c5c9aafe78/schema)