Skip to main content
POST
cURL
Creates a customer using your application’s stable user ID in the environment selected by your API key, or returns the customer already associated with that ID. Send a nonempty customerId of at most 255 characters. The response echoes it with created: true for a new record or created: false for a repeat call. This operation is safe to retry and does not attach a plan, create a Stripe customer, or grant credits by itself. The API key scopes the ID to your organization; another organization can use the same customer ID independently. After creation, use Attach a plan or add-on to start billing, then Check credits to read the balance. Invalid input returns 400 invalid_request; a missing or invalid key returns 401 unauthorized. See Customers for the complete lifecycle.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
customerId
string
required
Required string length: 1 - 255

Response

Customer created or returned without granting credits

customerId
string
required
created
boolean
required