---
title: organization_invitation_create
url: "/docs/ai-agents/mcp-tools/organizations/organization_invitation_create/"
canonical_url: https://docs.blossom88.com/docs/ai-agents/mcp-tools/organizations/organization_invitation_create/
markdown_url: https://docs.blossom88.com/docs/ai-agents/mcp-tools/organizations/organization_invitation_create.md
summary: Invite someone to the Organization by email, such as sam@example.com as a
  member, with Account access.
categories:
- mcp
- reference
---

# organization_invitation_create

Invite someone to the Organization by email, such as sam@example.com as a member, with Account access.

| | |
|---|---|
| Access | Changes Blossom |
| Same as | [`blossom organization:invitation:create`](/docs/reference/cli/organization/invitation/create/) |

## Arguments

| Argument | Type | Description |
|---|---|---|
| `data` | object | The invitation, as in invitation.yml. Required. |
| `data.name` | string | Their name. |
| `data.email` | string | Their email. |
| `data.role` | string | admin or member. |
| `data.account_access` | string | all or selected. |
| `data.access_mode` | string | full_access or read_only. |
| `data.permission_set_id` | string | Permission Set id. |
| `data.scopes` | string list | Custom permission scopes; permission_set_scopes lists them. |
| `data.invitation_account_grants_attributes` | object list | Per-Account access. |
| `data.invitation_account_grants_attributes[].id` | string | — |
| `data.invitation_account_grants_attributes[].account_id` | string | — |
| `data.invitation_account_grants_attributes[].selected` | boolean | — |
| `data.invitation_account_grants_attributes[].account_role` | string | — |
| `data.invitation_account_grants_attributes[].access_mode` | string | — |
| `data.invitation_account_grants_attributes[].permission_set_id` | string | — |
| `data.invitation_account_grants_attributes[]._destroy` | boolean | — |
| `data.invitation_account_grants_attributes[].scopes` | string list | — |

## Example

```json
{"data":{"clone_url":"https://github.com/acme/shop","services":[{"name":"web","command":"web","port":3000,"publicly_exposed":true}]}}
```