MCP documentation | MCP docs for agents

ark_invite_user

ark.invite_user

Invite a broker user or reactivate an inactive organization user, then assign teams in the same admin action.

Availability
Expanded preview
Scopes
admin:write
ARK permissions
None
Team visibility
Not entity-scoped
Approval policy
ask_before_write
ARK approval request
Required before execution
Idempotency
Required for external execution
Read-only
No
Destructive
No
External side effect
Yes
Rate limit
OAuth MCP credential and organization budgets

Input

emailstringrequired

Email address for the invited or reactivated user.

format: email; max length: 320

firstNamestringrequired

User first name.

min length: 2; max length: 100

lastNamestringrequired

User last name.

min length: 2; max length: 100

teamIdsarray<string>

Team IDs to assign. Omit only when the organization has a single team.

min items: 1; max items: 100

defaultTeamIdstring

Default team ID. Required when the organization has multiple teams.

format: uuid

Result

The tool returns the canonical ark.invite_user operation result in structuredContent and mirrors the same JSON as text. Errors set isError: true and return a stable error code, message, and optional details.