---
title: "Invite user to a team"
method: POST
path: "/team/{team_id}/request"
---

# Invite user to a team

`POST /team/{team_id}/request`

## Request

- Base URL: `https://api.signnow.com`
- URL: `https://api.signnow.com/team/{team_id}/request`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/signnow/apis/signnow-api/docs/team/:team_id/request/post.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint allows API users to invite users to a team.

## Request body

- object
  - `emails` string[], required: Email addresses of the users to invite.

## Response `200`

Invite results, one per email address in the request.

- object
  - `team_requests` object[]: Invite results.
    - `id` string: ID of the team invite. Use it as `request_id` in other team invite requests.
    - `email` string: Email address of the invited user.
    - `status` string: Result of the invite for this email address, for example `success`.

## Other responses

- `400`: * Incorrect or empty payload. * One or more emails adresses are incorrect. * User is not in the team. * Team not found.

---

[API](https://skmtc.dev/signnow/apis/signnow-api.md) - [All operations](https://skmtc.dev/signnow/apis/signnow-api/llms.txt) - [OpenAPI document](https://skmtc.dev/signnow/apis/signnow-api/revisions/1c9c30a6142b?raw)