---
title: "Invite team member"
method: POST
path: "/teams/{name}/invites"
---

# Invite team member

`POST /teams/{name}/invites`

Invite a new team

## Path parameters

- `name` string, required — The name of the team to invite someone to

## Request body

- InviteTeamMemberParams
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `emails` string, required — The email addresses of the people to invite. It can be a list in any format (comma separated, newline separated, etc.) and it will be parsed into individual addresses
  - `message` string — Optional message to include in the invite email
  - `role` 'admin' | 'developer', nullable, required — The role to assign to the invitations

## Response `200`

OK

- InviteTeamMemberResponse
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `team_invitations` TeamInvitation[], required — The team invitation that you created
    - `email` string, required
    - `invitation_sent_at` string, date-time, required
    - `role` string, required
    - `team` Team, required
      - `execution_region` string, required
      - `name` string, required
      - `organization` string, required — The name of the organization this team belongs to.
      - `slug` string — This property is deprecated. Use name instead.
      - `token` Token
        - `access_token` string, required — The access token to use when authenticating API requests with Tower.
        - `jwt` string, required — This property is deprecated. Use access_token instead.
        - `refresh_token` string — The refresh token to use when refreshing an expired access token. For security reasons, refresh tokens should only be transmitted over secure channels and never logged or stored in plaintext. It will only be returned upon initial authentication or when explicitly refreshing the access token.
      - `type` string, required — The type of team, either 'personal' or 'team'.

## Other responses

- `default` — Error

---

[API](https://skmtc.net/tower/apis/tower-api.md) · [All operations](https://skmtc.net/tower/apis/tower-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tower/tower-api/revisions/0e42b0fb26d9/schema)