---
title: "createOrgInvitation"
description: "Invite someone to the organization"
canonical: "https://pgbeam.com/docs/ts-sdk/account/createOrgInvitation"
last-updated: "2026-09-07T06:13:50.000Z"
---

# createOrgInvitation

> Invite someone to the organization

URL: https://pgbeam.com/docs/ts-sdk/account/createOrgInvitation

Creates an invitation and emails it. Inviting an address that already has a pending invitation returns a conflict rather than a second invitation. `owner` cannot be invited: ownership transfer is a separate, higher-privilege flow.

## Usage

## Parameters

Parameter

Type

Required

Description

pathParams.org\_id

`string`

Yes

Unique organization identifier.

body.email

`string`

Yes

Address to invite.

body.role

`AssignableOrgRole`

No

A role that can be assigned through the member API. This is `OrgRole` without `owner`: ownership is transferred through a separate flow, so requesting it here is rejected with a 400.

## Response

`Promise<OrgInvitation>`: the invitation was created.

## Example

## Errors

Status

Description

400

Invalid request parameters.

401

Missing or invalid authentication.

403

Operation not allowed by current plan limits.

404

Resource not found.

409

Resource already exists or conflicts with current state.

429

Rate limited. Try again later.