---
title: "Create a guest"
method: POST
path: "/guests"
tags: ["guests"]
---

# Create a guest

`POST /guests`

Guests are only there to upload, edit, and download files and perform their tasks in a specific Space.

## Headers

- `Authorization` string, required
- `X-Disable-Hooks` 'true', required

## Request body

- TypeGuestsGuestConfig[]
  - `environmentId` string, required — Environment ID
  - `email` string, required
  - `name` string, required
  - `spaces` TypeGuestsGuestSpace[], required
    - `id` string, required — Space ID
    - `workbooks` TypeGuestsGuestWorkbook[]
      - `id` string, required — Workbook ID
    - `sheets` TypeGuestsGuestSheet[]
      - `id` string, required — Sheet ID
    - `lastAccessed` string, date-time

## Response `200`

Response with status 200

- TypeGuestsCreateGuestResponse
  - `data` TypeGuestsGuest[], required
    - `environmentId` string, required — Environment ID
    - `email` string, required
    - `name` string, required
    - `spaces` TypeGuestsGuestSpace[], required
      - `id` string, required — Space ID
      - `workbooks` TypeGuestsGuestWorkbook[]
        - `id` string, required — Workbook ID
      - `sheets` TypeGuestsGuestSheet[]
        - `id` string, required — Sheet ID
      - `lastAccessed` string, date-time
    - `id` string, required — Guest ID
    - `createdAt` string, date-time, required — Date the guest object was created
    - `updatedAt` string, date-time, required — Date the guest object was last updated

---

[API](https://skmtc.net/flatfile/apis/api-reference.md) · [All operations](https://skmtc.net/flatfile/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/flatfile/api-reference/revisions/9d3a9979cd96/schema)