# Invite a new member to the organization

POST/api/v1/organizations/{id}/invitations

Creates a pending invitation for an email with the given role. Admin only. Fails if the email already belongs to a member or already has a pending invitation.

Path parameters

`id`integerrequired

Organization id

Body parameters

`email`string · emailrequired

`role`stringrequired

Organization role. admin: manage members and billing, plus everything readwrite can do. readwrite: start sessions, create API keys, delete sessions. readonly: view sessions, API keys, and test results only.

Returns

`id`string · uuidrequired

`email`string · emailrequired

`role`stringrequired

Organization role. admin: manage members and billing, plus everything readwrite can do. readwrite: start sessions, create API keys, delete sessions. readonly: view sessions, API keys, and test results only.

`status`stringrequired

`inviter`string · uuidnullable

Reference to the inviting user

`createdAt`string · date-timerequired

`expiresAt`string · date-timenullable

Request

```
curl https://api.mobilenexthq.com/api/v1/organizations/{id}/invitations \

  -X POST \

  -H 'Authorization: Bearer mob_...' \

  -H 'Content-Type: application/json' \

  -d '{"email":"string","role":"admin"}'
```

Response

201400401403404409

Invitation created

```
{

  "id": "string",

  "email": "string",

  "role": "admin",

  "status": "pending",

  "inviter": "string",

  "createdAt": "2026-01-01T00:00:00Z",

  "expiresAt": "2026-01-01T00:00:00Z"

}
```