---
title: "Create an invitation to a collection"
method: POST
path: "/collections/{collection_id}/invitations"
tags: ["invitations"]
---

# Create an invitation to a collection

`POST /collections/{collection_id}/invitations`

Creates an invitation to the matching collection.

## Request body

- InvitationCreationRequest
  - `data` object, required
    - `attributes` object, required
      - `email` string, required — Email address of invitee.
      - `permission_level` 'guest' | 'collaborator' | 'admin' | 'owner', required — Access to grant invitee. > **Note:** `owner` is only valid when inviting someone to an Organization. Learn more about the permission levels you can grant Users in our Knowledge Base article on <a href="https://help.smartsheet.com/115002602273-User-Permissions" target="_blank">User Permissions</a>.
      - `personal_message` string — A message for invitee.
      - `prevent_email` boolean — Set this to `true` to skip sending an invitation email to the invitee.

## Response `200`

The new invitation.

- object
  - `data` object, required
    - `attributes` Invitation
      - `id` string, required — Unique identifier for the resource instance.
      - `type` 'invitations', required — The type of the resource.
      - `attributes` InvitationAttributes, required
        - `email` string, required — Email address of the recipient.
        - `permission_level` string — Access to grant the recipient.
        - `personal_message` string — A message for the recipient.
        - `invitation_url` string — The invitation's URL.
  - `meta` object, required
    - `auto_accepted` boolean

## Other responses

- `default` — Generic error payload

---

[API](https://skmtc.net/smartsheet/apis/brandfolder-openapi-reference.md) · [All operations](https://skmtc.net/smartsheet/apis/brandfolder-openapi-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartsheet/brandfolder-openapi-reference/versions/fd95b0a2d2f8/schema)