Create or reuse a customer

POST

/api/customers

curl --request POST \
  --url https://example.com/api/customers \
  --header 'Content-Type: application/json' \
  --cookie better-auth.session_token=<better-auth.session_token> \
  --data '{ "name": "example", "source": "example" }'

• Solivio API origin

Authorizations

• sessionCookie

Request Body ^required

Customer display name.

Media type application/json

object

name

required

string

>= 1 characters

source

string

>= 1 characters

Example ^generated

{
  "name": "example",
  "source": "example"
}

Responses

201

The created or existing customer.

Media type application/json

object

customer

required

A customer available for offer assignment.

object

id

required

string

name

required

string

source

required

string

Example ^generated

{
  "customer": {
    "id": "example",
    "name": "example",
    "source": "example"
  }
}

400

The request body could not be parsed or validated.

Media type application/json

Standard API error payload.

object

error

required

object

code

required

string

message

required

string

issues

Array<string>

Example ^generated

{
  "error": {
    "code": "example",
    "message": "example",
    "issues": [
      "example"
    ]
  }
}

401

No valid Better Auth session was present.

Media type application/json

Returned when no valid Better Auth session is present.

object

error

required

string

Example ^generated

{
  "error": "example"
}