---
title: "Create a group"
method: POST
path: "/4.0/guestlists/{guestlist_id}/groups"
tags: ["Guest Groups"]
---

# Create a group

`POST /4.0/guestlists/{guestlist_id}/groups`

## Path parameters

- `guestlist_id` string, required

## Request body

- GroupBulkGuestListService
  - `action` 'CREATE' | 'DELETE', required
  - `guests` GuestsGuestListService[], required
    - `id` string, required — id of guest
    - `first_name` string, required — first name of guest
    - `last_name` string, required — last name of guest
    - `email` string — email address
    - `checked_in_status` object — checkin data
      - `checked_in` integer
      - `checked_in_at` string, date-time
      - `checked_out_at` string, date-time
    - `tags` TagsGuestListService[]
      - `title` string, required — title of tag
      - `color` string — color of tag
    - `meals` MealsGuestListService[]
      - `title` string, required — name of meal

## Response `200`

group created

## Other responses

- `400` — Error creating group
- `410` — guestlist is deleted

---

[API](https://skmtc.net/socialtables/apis/social-tables-api-gateway.md) · [All operations](https://skmtc.net/socialtables/apis/social-tables-api-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/socialtables/social-tables-api-gateway/versions/221c9d836cf0/schema)