Invite Member

POST

https://api.pibox.com/v1/account/teams/invite_member

Invite a new user to a team with an explicit role. Targets team_id must belong to the caller's organization. Honors the team's disable_invite_for_members setting (admins/owners always pass). Universal handler — works for existing users (added immediately), new users (pending invite via email), and optionally adds to a project via chat_id.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

Invitation queued

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠409

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.pibox.com/v1/account/teams/invite_member' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "team_id": 737,
    "email": "user@example.com",
    "role": "guest",
    "chat_id": 12345
}'

Response Example

200 - Success Example

{
    "object": "invitation",
    "team_id": 737,
    "email": "user@example.com",
    "role": "guest",
    "chat_id": null
}

Modified at 2026-06-09 10:03:31

Get File Statuses