# Create organization invitations

**POST /organizations/{organization_id}/invitations**

Creates or refreshes organization invitations. Currently unavailable in self-hosted ECE.


## Servers
- https://api.elastic-cloud.com/api/v1: https://api.elastic-cloud.com/api/v1 ()



## Parameters

### Path parameters
- **organization_id** (string)
  Identifier for the Organization


### Body: application/json (object)
The organization invitations to create or refresh
- **emails** (array[string])
  The email addresses to invite to the organization
- **expires_in** (string)
  The date and time when the invitation expires. Defaults to three days from now.
- **role_assignments** (object)
  Roles assigned to users, API keys or organization invitations. Currently unavailable in self-hosted ECE.


## Responses
### 201
Organization invitations created successfully

#### Body: application/json (object)
- **invitations** (array[object])
  The list of organization invitations

### 400
* Invitation email was not valid. (code: `organization.invitation_invalid_email`)
* Invitation already sent. (code: `organization.invitation_already_exists`)
* User already belongs to organization. (code: `organization.user_organization_already_belongs`)
#### Headers
- **x-cloud-error-codes** (string)
  The error codes associated with the response

#### Body: application/json (object)
- **errors** (array[object])
  A list of errors that occurred in the failing request

### 403
The current user authentication is not valid. (code: `root.invalid_authentication`)
#### Headers
- **x-cloud-error-codes** (string)
  The error codes associated with the response

#### Body: application/json (object)
- **errors** (array[object])
  A list of errors that occurred in the failing request

### 404
* Organization not found. (code: `organization.not_found`)
* User not found. (code: `user.not_found`)
* Invitation sender does not belong to organization. (code: `organization.user_organization_does_not_belong`)
#### Headers
- **x-cloud-error-codes** (string)
  The error codes associated with the response

#### Body: application/json (object)
- **errors** (array[object])
  A list of errors that occurred in the failing request

### 429
Request exceeds organization invitation creation rate limits. (code: `organization.invitations_rate_limit_exceeded`)
#### Headers
- **x-cloud-error-codes** (string)
  The error codes associated with the response

#### Body: application/json (object)
- **errors** (array[object])
  A list of errors that occurred in the failing request


[Powered by Bump.sh](https://bump.sh)