---
title: "Create organization invitation"
method: POST
path: "/api/organizations/{organization_id}/invitations/"
tags: ["organizations"]
---

# Create organization invitation

`POST /api/organizations/{organization_id}/invitations/`

## Request

- Base URL: `https://docs.blindinsight.io` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.blindinsight.io/api/organizations/{organization_id}/invitations/`
- Auth: one of:
  - API key in cookie `sessionid`
  - HTTP basic
  - HTTP bearer
- TypeScript: <https://skmtc.dev/blindinsight/apis/blind-insight-rest-api/docs/api/organizations/:organization_id/invitations/post.ts> (a function with typed inputs; its response is checked against the schema)

Invite a user to join an organization.

The response is the newly created invitation object.

**On the command line:**

```bash
blind organizations invitations create --organization-id "<organization-id>" --data organization-invitation.json
```

## Path parameters

- `organization_id` string, required

## Request body

- OrganizationInvitationCreate: HyperlinkedModelSerializer with `id` as the first field.
  - `id` string, required
  - `url` string, uri, required
  - `organization` string, uri
  - `email` string, email, required
  - `created` string, date-time, required
  - `modified` string, date-time, required
  - `is_admin` boolean

## Response `201`

- OrganizationInvitationCreate: HyperlinkedModelSerializer with `id` as the first field.
  - `id` string, required
  - `url` string, uri, required
  - `organization` string, uri
  - `email` string, email, required
  - `created` string, date-time, required
  - `modified` string, date-time, required
  - `is_admin` boolean

---

[API](https://skmtc.dev/blindinsight/apis/blind-insight-rest-api.md) - [All operations](https://skmtc.dev/blindinsight/apis/blind-insight-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/blindinsight/apis/blind-insight-rest-api/revisions/0ac902401cea?raw)