---
title: Invitations
summary: Invitations allow superusers and engineers to invite users to set up accounts as collaborators under a main customer account. Superusers can invite collaborators and assign them any role or permission level on a per-service basis. Engineers with no per-service limitations can only invite new collaborators but cannot modify their permissions.
url: https://www.fastly.com/documentation/reference/api/account/invitations
---

Invitations allow superusers and engineers to invite users to set up accounts as collaborators under a main customer account. Superusers can invite collaborators and assign them any role or permission level on a per-service basis. Engineers with no per-service limitations can only invite new collaborators but cannot modify their permissions.

## Data model

| Field | Type | Description |
|-------|------|-------------|
| `email` | string | The email address of the invitee. |
| `limit_services` | boolean | Indicates the user has limited access to the customer's services. |
| `role` | string | The permissions role assigned to the user. Can be <code>user</code>, <code>tls_viewer</code>, <code>tls_admin</code>, <code>billing</code>, <code>engineer</code>, or <code>superuser</code>. |
| `roles` | array |  |
| `status_code` | integer | Indicates whether or not the invitation is active. |
| `type` | string | Resource type. |
| `created_at` | string | Date and time in ISO 8601 format. (Read-only) |
| `deleted_at` | string | Date and time in ISO 8601 format. (Read-only) |
| `id` | string | Alphanumeric string identifying an invitation. (Read-only) |
| `relationships.customer.id` | string | Alphanumeric string identifying the customer. |
| `updated_at` | string | Date and time in ISO 8601 format. (Read-only) |

## API endpoints

### List invitations

**GET** `/invitations`

List all invitations.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `page[number]` | integer | query | No | Current page. |
| `page[size]` | integer | query | No | Number of records per page. |

### Create an invitation

**POST** `/invitations`

Create an invitation.

### Delete an invitation

**DELETE** `/invitations/{invitation_id}`

Delete an invitation.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `invitation_id` | string | path | Yes | Alphanumeric string identifying an invitation. |