---
title: "Save a client (create or update)"
method: POST
path: "/clients/save"
tags: ["Clients"]
---

# Save a client (create or update)

`POST /clients/save`

Creates or updates a client. If `client.id` is provided, that client is updated; otherwise the API may match an existing client by name/email before creating a new one.

## Request body

- object
  - `client` object

## Response `200`

Saved

- SuccessEnvelope
  - `data` unknown
  - `success` true, required

## Other responses

- `400` — Bad Request
- `401` — Invalid API key
- `409` — Conflict
- `500` — Internal Server Error

---

[API](https://skmtc.dev/vocal/apis/magic-heidi-invoicing-software-api.md) · [All operations](https://skmtc.dev/vocal/apis/magic-heidi-invoicing-software-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/vocal/magic-heidi-invoicing-software-api/revisions/591ae048f0a0/schema)