---
title: "POST /admin/organizations/{org_id}/invites"
method: POST
path: "/admin/organizations/{org_id}/invites"
tags: ["Admin"]
---

# POST /admin/organizations/{org_id}/invites

`POST /admin/organizations/{org_id}/invites`

## Request

- Base URL: `https://api.breeze.baby`
- URL: `https://api.breeze.baby/admin/organizations/{org_id}/invites`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/breeze-baby/apis/breeze-api/docs/admin/organizations/:org_id/invites/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `org_id` string, required

## Request body

- CreateOrganizationInviteRequest: Request body for creating an organization invitation
  - `email_address` string, required: Email address to send the invitation to
  - `inviter_user_id` string, nullable: Optional: User ID of the person creating the invitation (for tracking purposes)
  - `role` string: Role to assign to the invited user (e.g., "org:member", "org:admin")

## Response `200`

Invitation created successfully

- CreateOrganizationInviteResponse: Response for creating an organization invitation
  - `invitation` AdminOrganizationInvitation, required: Organization invitation from Clerk
    - `created_at` integer, required: When the invitation was created (Unix timestamp)
    - `email_address` string, required: Email address the invitation was sent to
    - `id` string, required: Invitation ID
    - `role` string, required: Role assigned to the invitation
    - `status` string, required: Status of the invitation (pending, accepted, revoked)
  - `message` string, required: Success message

## Other responses

- `400`: Bad request - invalid email or role
- `404`: Organization not found
- `500`: Internal server error

---

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