---
title: "Create a customer"
method: POST
path: "/v1/partner/customers"
tags: ["Customers"]
---

# Create a customer

`POST /v1/partner/customers`

Creates a customer under the authenticated partner tenant. Returns `201 Created` for a new customer, or `200 OK` when a customer with the same email already exists and is returned instead of duplicated (`created: false`). Idempotent on the `Idempotency-Key` header: replaying the same key returns the original result — the same response and status as the first call — never a duplicate. If a create fails before it commits, the key is released; fix the request and retry with the same key.

## Headers

- `Idempotency-Key` string, required

## Request body

- CreateCustomerRequestDto — Request body to create a customer under your partner tenant.
  - `email` string, required — Customer email address.
  - `firstName` string, required — Customer legal first name.
  - `lastName` string, required — Customer legal last name.
  - `countryOfResidence` string, required — ISO 3166-1 alpha-3 country of residence (e.g. USA).
  - `phoneNumber` string — Customer phone number in E.164 format. Optional.

## Response `200`

OK

---

[API](https://skmtc.dev/doola/apis/doola-partner-api.md) · [All operations](https://skmtc.dev/doola/apis/doola-partner-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/doola/doola-partner-api/revisions/e0dd4d79ff88/schema)