---
search:
  tags:
    - TeamMembers
    - POST
seo:
  description: >-
    User-gated (chrm_user_* or session); caller must be a team owner/admin,…
    Reference for the POST /api/v1/teams/{teamId}/members endpoint in the
    Charming API.
sidebar:
  label: Add a member to a team
  badge: POST
title: Add a member to a team
type: openapi-operation
---
User-gated (`chrm_user_*` or session); caller must be a team owner/admin, and only an owner may grant the `owner` role. The grantee (handle or email) must already hold a Charming account.

`POST /api/v1/teams/{teamId}/members`

Found a bug or need a feature? [Tell us](/docs/capabilities/feedback) with `submit_feedback` or `POST /app/{id}/feedback`. Your feedback shapes what we build next.