---
title: "Create an organization invite for a specific user"
method: POST
path: "/orgs/{org}/invites/"
tags: ["orgs"]
---

# Create an organization invite for a specific user

`POST /orgs/{org}/invites/`

Create an organization invite for a specific user

## Request body

- OrganizationInviteRequest
  - `email` string, email — The email of the user to be invited.
  - `role` 'Owner' | 'Manager' | 'Member' | 'Collaborator' — The role to be assigned to the invited user.
  - `teams` OrganizationTeamInvite[]
    - `role` 'Manager' | 'Member' — The role to be assigned to the invited user in the team.
    - `team` string, slug, required — The team identifier (slug).
  - `user` string — The slug of the user to be invited.

## Response `201`

Invite sent

- OrganizationInvite
  - `email` string, email — The email of the user to be invited.
  - `expires_at` string, date-time
  - `inviter` string
  - `inviter_url` string, uri, nullable
  - `org` string
  - `role` 'Owner' | 'Manager' | 'Member' | 'Collaborator' — The role to be assigned to the invited user.
  - `slug_perm` string, slug
  - `teams` OrganizationTeamInvite[]
    - `role` 'Manager' | 'Member' — The role to be assigned to the invited user in the team.
    - `team` string, slug, required — The team identifier (slug).
  - `user` string — The slug of the user to be invited.
  - `user_url` string, uri, nullable

## Other responses

- `400` — The invite cannot be created.
- `422` — Missing or invalid parameters (see detail).

---

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