Send Invitation
send_invitationInvite someone by email to the organization and to one or more of its workspaces, each with a role. AdaptlyPost emails the invitation, which lasts 7 days; on accepting, the person joins with organizationRole and each listed workspace with its role. Confirm the email, workspaces and roles with the user first. Needs the members.manage permission, which Admin holds. A member who is not an organization owner or admin may only invite org-member, only to workspaces where they hold members.manage, and only with a role no higher than their own there; only the owner may invite an org-admin, and only an organization owner or admin may set creditAllowance. Otherwise it fails with 403 permission_denied. Fails with 403 subscription_required when the plan has no team seat left: tell the user to upgrade and do not retry. Fails with 400 when the person is already a member or already invited.
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>",
"workspaces": "<workspaces>"
},
"name": "send_invitation"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| Yes | Email address to invite | ||
| workspaces | Yes | Workspaces the person joins on accepting, at least one, each with its role | |
| workspaceId | No | Workspace to act in: an id from list_workspaces. Omit to act in the workspace list_workspaces marks current. Use the same workspaceId for every call about the same workspace, since ids from one workspace (accounts, posts, uploads) do not exist in another | |
| creditAllowance | No | AI credits the member may spend from the owner's pool: { mode: "MONTHLY", monthlyAmount } or { mode: "FIXED", balance }. Leave out for none. Only an organization owner or admin may set it | |
| organizationRole | No | Role in the organization: org-member (the default) or org-admin. Only the organization owner may invite an org-admin |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes | The invitation: id, email, organizationId, organizationRole, status (pending, accepted, expired or revoked), workspaces [{ workspaceId, workspaceName, role }], expiresAt and createdAt. |