---
title: "Invite team member"
method: POST
path: "/api/user/teams/{id}/members"
tags: ["Teams"]
---

# Invite team member

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

## Request

- Base URL: `https://demo.hitkeep.com`
- URL: `https://demo.hitkeep.com/api/user/teams/{id}/members`
- Auth: API key in cookie `hk_token`

Creates a pending invite for a user or updates the role of an existing member.

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `email` string, email, required
  - `role` 'owner' | 'admin' | 'member', required

## Response `200`

Invite or update response

- object
  - `invite` TeamInvite
    - `accepted_at` string, date-time
    - `created_at` string, date-time
    - `created_by` string, uuid
    - `email` string, email
    - `expires_at` string, date-time
    - `id` string, uuid
    - `invited_user_id` string, uuid
    - `revoked_at` string, date-time
    - `role` string
    - `status` string
    - `team_id` string, uuid
  - `is_invite` boolean
  - `status` string

## Other responses

- `403`: Access denied
- `409`: Invite already pending

---

[API](https://skmtc.dev/hitkeep/apis/hitkeep-rest-api.md) · [All operations](https://skmtc.dev/hitkeep/apis/hitkeep-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hitkeep/apis/hitkeep-rest-api/revisions/bb2df36ab2a4?raw)