---
title: "Create a Stripe customer"
method: POST
path: "/v1/payments/create-customer"
tags: ["Stripe Payments"]
---

# Create a Stripe customer

`POST /v1/payments/create-customer`

Creates a Stripe Customer early in the funnel (e.g., at email capture). The customer ID can be reused when creating a subscription later. If a customer with this email already exists, returns the existing customer.

## Request body

- CreateCustomerDto
  - `email` string, required — Customer email address
  - `webUserId` string — Web user ID from tracking system

## Response `200`

Customer created or found successfully

- CreateCustomerResponseDto
  - `customerId` string, required — Stripe Customer ID
  - `isNew` boolean, required — Whether the customer was newly created

## Other responses

- `400` — Invalid request parameters or Stripe error

---

[API](https://skmtc.dev/miaai/apis/backend-template-api.md) · [All operations](https://skmtc.dev/miaai/apis/backend-template-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/miaai/backend-template-api/revisions/2a8d88a5124f/schema)