corestack_ team_ member_ invite
Invite a team member.
When to use it
Invite somebody to your company's team with one role. They get an email with a link to set up their account; until
they accept, corestack_team_members_list shows them as invite_sent. When somebody cannot be invited with a link, they
are told by email instead, and the invitation stays on your team as invite_sent until it expires or you remove it. That
email goes to an address at most once a day from your company (and five times a day in all); the invitation is made all
the same. The answer is the same either way. Use corestack_team_roles_list for the roles you may give (assignable: true). This is
the Control Panel's Invite User and POST /api/user/invite.
Ask for it
Using the Corefinity MCP server, call corestack_team_member_invite with name Sam Smith, email [email protected], role client-member-full. (Invite a team member.) Tell me what it returned.Inputs
Not already on your team. Up to 254 characters.
Up to 255 characters.
A role's slug you may give. Up to 255 characters.
Example call
{
"name": "corestack_team_member_invite",
"arguments": {
"name": "Sam Smith",
"email": "[email protected]",
"role": "client-member-full"
}
}If it is refused
| Reason | What to do |
|---|---|
forbidden | You may not invite people (an owner, or the invite users permission, may). |
owner_grant | Only an owner of the company, or Corefinity staff, may make someone an owner (agency-owner or client-owner); holding the edit users or invite users permission is not enough. Message: "Only an owner or Corefinity staff can make someone an owner." |
permission_grant | The role carries a permission you do not hold (a custom role always; a standard role unless you are an owner of the company or Corefinity staff). Message: "You can only give someone a role if you hold all of its permissions yourself." |
invite_company_gone | Your company is not active yet (for example, it is still awaiting its order), so nobody can be invited to its team until it is, and nothing was sent. Message: "This company is not active, so nobody can be invited to its team until it is." |
invalid_arguments | On email (not an address, or already on your team: "Someone with this email address is already on this team."), role ("You are not allowed to add this role to this company.") or name. |
tenant_mismatch | The object does not exist or the token may not see it. Check the id. |
scope_required | The token lacks a scope this call needs. Open the link in the answer to add it, then call again. |
pin_refused | The grant is limited to chosen clusters, sites or environments, and this call is outside them. Open the link in the answer to widen it. |
rate_limited | Too many calls. Wait for the number of seconds the answer names. |
temporarily_unavailable | The Control Panel could not answer just now. Nothing was started; try again shortly. |
internal_error | Something went wrong on our side. Quote the trace id to support. |