Invite user
invite_userInvite a person to join your organization by email at a chosen role. The organization is fixed by your context - never pass an organization id. Valid roles: Admin, Finance, Manager, Member, Viewer (you can only invite at a role no more privileged than your own). Once the user confirms, the invitation is created and the invitee is emailed an acceptance link. The result's mail_sent says whether that email went out: say the invitation was emailed ONLY when mail_sent is true. When mail_sent is false the invitation exists but its email could not be sent - say so, and that an admin can resend it or copy its link from the Users page.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"email": "<email>",
"role": "<role>"
},
"name": "invite_user"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| role | Yes | Role to grant on acceptance (required). One of: Admin, Finance, Manager, Member, Viewer. You cannot invite at a role more privileged than your own. | |
| Yes | Email address of the person to invite (required). | ||
| idempotency_key | No | Optional caller-supplied key; retrying with the same key returns the original result instead of acting twice. |