---
title: "Create a new invitation from this account"
method: POST
path: "/accounts/{id}/invitations"
tags: ["roles"]
---

# Create a new invitation from this account

`POST /accounts/{id}/invitations`

Creates a new invitation and returns the definition

## Path parameters

- `id` string, required

## Request body

- RoleInvitationPost — The current state of a role invitation
  - `user_email` string — An email address
  - `role` string — A reference to this role

## Response `200`

The invitation was successfully created

- RoleInvitation — The current state of a role invitation
  - `state` 'queued' | 'accepted' | 'sent' | 'declined' — A reference to this role
  - `href` string — A reference to this role
  - `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
  - `role` string — A reference to this role

---

[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)