# Create Google Drive permission

Canonical URL: https://docs.fuse.init.inc/integrations/google-workspace/actions/drive.permissions.create

Create a permission on a Drive file the connected principal can access.

Action ID: `drive.permissions.create`
Provider: Google Workspace (`google_workspace`)
Contract version: 1

## Risk and exposure

- Risk: Write
- Idempotency: Safe — Safe to retry without coordination; repeats do not create additional side effects.
- Availability: Default
- Exposure: REST, SDK, MCP
- MCP hints: readOnly=false, destructive=false, idempotent=true, openWorld=true

## Required scopes

- `https://www.googleapis.com/auth/drive`

## Input schema fields

- `file_id`
- `role`
- `type`
- `email_address`
- `domain`

## Output schema fields

- `id`
- `role`
- `type`
- `email_address`
- `domain`
- `view`
- `allow_file_discovery`
- `expires_at`
- `deleted`
- `pending_owner`
- `inherited_permissions_disabled`
- `permission_details`
- `permission_details[]`
- `permission_details[].permission_type`
- `permission_details[].role`
- `permission_details[].inherited`
- `permission_details[].inherited_from_id`

Provider overview: https://docs.fuse.init.inc/integrations/google-workspace
Actions index: https://docs.fuse.init.inc/integrations/google-workspace/actions
Exact canonical JSON contract: https://docs.fuse.init.inc/api/catalog/v1/providers/google_workspace/actions/drive.permissions.create
Deployment-effective discovery: https://api.fuse.init.inc/v1/tenants/%7Btenant_id%7D/providers/google_workspace/actions