---
title: "Create or update a guest"
method: POST
path: "/api/v1/guests"
tags: ["Guests"]
---

# Create or update a guest

`POST /api/v1/guests`

## Request

- Base URL: `https://www.gerezi.com`
- URL: `https://www.gerezi.com/api/v1/guests`
- Auth: HTTP bearer

Upserts by email + restaurant. Returns 200 if existing, 201 if new.

## Request body

- object
  - `email` string, email, required
  - `first_name` string
  - `last_name` string
  - `phone` string

## Response `200`

Existing guest updated

## Other responses

- `201`: New guest created
- `401`: Missing or invalid API key

---

[API](https://skmtc.dev/gerezi/apis/gerezi-restaurant-api.md) · [All operations](https://skmtc.dev/gerezi/apis/gerezi-restaurant-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gerezi/apis/gerezi-restaurant-api/revisions/323b530e81cb?raw)