---
title: "Invite a user to a group"
method: POST
path: "/accounts/{id}/group-invitations"
tags: ["groups"]
---

# Invite a user to a group

`POST /accounts/{id}/group-invitations`

Invites a user to a group and returns the invitation

## Path parameters

- `id` string, required

## Request body

- GroupInvitationPost — A group invitation invites a user to a particular group.
  - `user_email` string — An email address
  - `group` string — A reference to this group

## Response `200`

The invitation was successfully sent.

- GroupInvitation — A group invitation invites a user to a particular group.
  - `state` 'queued' | 'accepted' | 'sent' | 'declined' — The current state of the group invitation.
  - `href` string — A reference to this group
  - `created` string — An iso8601 formatted timestamp
  - `sent` string — An iso8601 formatted timestamp
  - `granted_by` string — The user that sent the invitation
  - `user_email` string — An email address
  - `group` string — A reference to this group

---

[API](https://skmtc.dev/webscale/apis/webscale-apis.md) · [All operations](https://skmtc.dev/webscale/apis/webscale-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/webscale/webscale-apis/revisions/c98d872b50cb/schema)