---
title: "Create Invite For A User To Join The Organization By Email"
method: POST
path: "/api/v2/organization/invite"
tags: ["Organization"]
---

# Create Invite For A User To Join The Organization By Email

`POST /api/v2/organization/invite`

Send an email invitation for a user to join the organization.

An invitation email will be sent to the specified address with a link to accept the invitation.
Organization admins can invite users to any branch, while branch admins can only invite to their own branches.

## Headers

- `language` 'AR' | 'EN'

## Request body

- OrganizationInviteCreate
  - `email` string, email, required — Email address of the user to invite. May already be registered; rejected only if they are already a member of this organization.
  - `role` 'organization_admin' | 'branch_admin' | 'branch_user', required
  - `branches` string[], required — List of branch IDs where the user will have access.

## Response `200`

Successful Response

- OrganizationInviteResponse
  - `id` string, uuid
  - `email` string, email
  - `organization_id` string, uuid
  - `expire_at` string, date-time
  - `created_by` string, uuid
  - `role` 'organization_admin' | 'branch_admin' | 'branch_user'
  - `branches` string[]

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/streampay/apis/stream-app.md) · [All operations](https://skmtc.dev/streampay/apis/stream-app/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/streampay/stream-app/revisions/515eeea7d260/schema)