---
title: "Create a customer, or update the given fields when the email already exists"
method: POST
path: "/customers"
tags: ["customers"]
---

# Create a customer, or update the given fields when the email already exists

`POST /customers`

## Request

- Base URL: `https://daybag.io/api/v1`
- URL: `https://daybag.io/api/v1/customers`
- Auth: HTTP bearer

## Request body

- object
  - `name` string
  - `phone` string
  - `notes` string
  - `metadata` object
  - `email` string, email, required

## Response `200`

Success

- object
  - `id` string, required
  - `org_id` string, required
  - `email` string, required: Lowercase; unique within the org
  - `name` string, required
  - `phone` string, required
  - `notes` string, required
  - `metadata` unknown, required
  - `created_at` string, required: ISO 8601 timestamp (UTC)

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/daybag/apis/daybooked-io-api.md) · [All operations](https://skmtc.dev/daybag/apis/daybooked-io-api/llms.txt) · [OpenAPI document](https://skmtc.dev/daybag/apis/daybooked-io-api/revisions/1f576dead370?raw)