Register a customer (idempotent upsert, no body)
PUT
/v1/customers/{external_customer_id}
const url = 'https://api.seal0.app/v1/customers/example';const options = {method: 'PUT', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request PUT \ --url https://api.seal0.app/v1/customers/example \ --header 'Authorization: Bearer <token>'Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”external_customer_id
required
string
Opaque customer ID; must match ^[A-Za-z0-9._:-]{1,255}$.
Header Parameters
Section titled “Header Parameters”Idempotency-Key
string
Optional; replays the stored response for 24 hours.
Responses
Section titled “Responses”The customer already existed.
Media typeapplication/json
object
created_at
required
string format: date-time
external_customer_id
required
string
id
required
string
updated_at
required
string format: date-time
Example generated
{ "created_at": "2026-04-15T12:00:00Z", "external_customer_id": "example", "id": "example", "updated_at": "2026-04-15T12:00:00Z"}The customer was created.
Media typeapplication/json
object
created_at
required
string format: date-time
external_customer_id
required
string
id
required
string
updated_at
required
string format: date-time
Example generated
{ "created_at": "2026-04-15T12:00:00Z", "external_customer_id": "example", "id": "example", "updated_at": "2026-04-15T12:00:00Z"}Error envelope.
Media typeapplication/json
object
error
required
object
code
required
Stable snake_case error code.
string
field
required
Offending input field, when known.
string
message
required
string
request_id
required
string
Example generated
{ "error": { "code": "example", "field": "example", "message": "example", "request_id": "example" }}Error envelope.
Media typeapplication/json
object
error
required
object
code
required
Stable snake_case error code.
string
field
required
Offending input field, when known.
string
message
required
string
request_id
required
string
Example generated
{ "error": { "code": "example", "field": "example", "message": "example", "request_id": "example" }}Error envelope.
Media typeapplication/json
object
error
required
object
code
required
Stable snake_case error code.
string
field
required
Offending input field, when known.
string
message
required
string
request_id
required
string
Example generated
{ "error": { "code": "example", "field": "example", "message": "example", "request_id": "example" }}default
Section titled “default”Error envelope.
Media typeapplication/json
object
error
required
object
code
required
Stable snake_case error code.
string
field
required
Offending input field, when known.
string
message
required
string
request_id
required
string
Example generated
{ "error": { "code": "example", "field": "example", "message": "example", "request_id": "example" }}