create_invitation

Send invitation

Create and email a workspace invitation.

Authorization and permissions

Requires a valid delegated OAuth token and access to the selected workspace.

OAuth scope: mcp:invitations
Workspace requirement: Authorized workspace and current membership required

Workspace administrator. Defaults are role=member, requires_linkedin=false, can_create_drafts=true, can_publish=false, and can_approve=false; requiring LinkedIn blocks applicable work until the invitee connects a personal profile.

Input schema

{
  "additionalProperties": false,
  "properties": {
    "can_approve": {
      "description": "Can approve.",
      "type": "boolean"
    },
    "can_create_drafts": {
      "description": "Can create drafts.",
      "type": "boolean"
    },
    "can_publish": {
      "description": "Can publish.",
      "type": "boolean"
    },
    "email": {
      "description": "Email.",
      "format": "email",
      "maxLength": 254,
      "type": "string"
    },
    "requires_linkedin": {
      "description": "Requires linkedin.",
      "type": "boolean"
    },
    "role": {
      "description": "Role.",
      "enum": [
        "admin",
        "member"
      ]
    },
    "team_id": {
      "description": "Consented workspace ID.",
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "team_id",
    "email"
  ],
  "type": "object"
}

Result schema

{
  "additionalProperties": false,
  "properties": {
    "invitation": {
      "additionalProperties": false,
      "description": "Invitation.",
      "properties": {
        "accepted": {
          "description": "Accepted.",
          "type": "boolean"
        },
        "can_approve": {
          "description": "Can approve.",
          "type": "boolean"
        },
        "can_create_drafts": {
          "description": "Can create drafts.",
          "type": "boolean"
        },
        "can_publish": {
          "description": "Can publish.",
          "type": "boolean"
        },
        "email": {
          "description": "Email.",
          "format": "email",
          "type": "string"
        },
        "id": {
          "description": "Id.",
          "format": "uuid",
          "type": "string"
        },
        "requires_linkedin": {
          "description": "Requires linkedin.",
          "type": "boolean"
        },
        "role": {
          "description": "Role.",
          "enum": [
            "admin",
            "member"
          ]
        }
      },
      "required": [
        "id",
        "email",
        "role",
        "requires_linkedin",
        "can_create_drafts",
        "can_publish",
        "can_approve",
        "accepted"
      ],
      "type": "object"
    }
  },
  "required": [
    "invitation"
  ],
  "type": "object"
}

Example arguments

{
  "can_approve": false,
  "can_create_drafts": true,
  "can_publish": false,
  "email": "[email protected]",
  "requires_linkedin": true,
  "role": "member",
  "team_id": 42
}

Example result

{
  "invitation": {
    "accepted": false,
    "can_approve": false,
    "can_create_drafts": true,
    "can_publish": false,
    "email": "[email protected]",
    "id": "018f3c96-0d74-7b2b-9e10-5ecbbcd82921",
    "requires_linkedin": true,
    "role": "member"
  }
}

Errors and retry

Workspace reads require current membership; workspace and invitation administration requires an administrator, while creation requires account-level mcp:teams. Invalid/duplicate slugs or pending emails are rejected; unknown or cross-workspace invitations return not found, and accepted invitations cannot be changed or cancelled. Calls are limited to 120 per user per minute.

Reads are safe to retry. Before retrying workspace or invitation creation after an ambiguous response, list current workspaces or invitations. Updates may be retried after reading current state; never blindly repeat workspace deletion or invitation cancellation.

Effects, limits, and source

Workspace roles, subscription and AI usage limits, approval rules, and server rate limits are enforced at call time. Rate-limit responses identify when to retry; scheduled work returns state rather than holding the request open.

teams.invitations.send_invitation and InvitationViewSet