---
title: "Create invitation"
method: POST
path: "/v1/orgs/{id}/invitations"
tags: ["Invitations"]
---

# Create invitation

`POST /v1/orgs/{id}/invitations`

## Request

- Base URL: `https://api.onegoodarea.com`
- URL: `https://api.onegoodarea.com/v1/orgs/{id}/invitations`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Create an invitation to join the organization.

## Path parameters

- `id` string, required

## Request body

- object
  - `email` string, email, required
  - `role` 'member' | 'admin', required

## Response `201`

Default Response

- object
  - `invitation` object, required
    - `id` string, required
    - `org_id` string, required
    - `email` string, email, required
    - `role` 'member' | 'admin', required
    - `invited_by_user_id` string, required
    - `expires_at` string, date-time, required
    - `created_at` string, date-time, required

## Other responses

- `403`: Default Response
- `404`: Default Response
- `409`: Default Response
- `500`: Default Response

---

[API](https://skmtc.dev/onegoodarea/apis/onegoodarea-api.md) · [All operations](https://skmtc.dev/onegoodarea/apis/onegoodarea-api/llms.txt) · [OpenAPI document](https://skmtc.dev/onegoodarea/apis/onegoodarea-api/revisions/b318d28b3412?raw)