Skip to content
On this page

/client/create

Creates or returns an existing client to be used with requests.

If a client already exists with the same identifier included in the request, the existing clientId is returned.

HTTP Request

POST https://api.q2open.io/v1/client

Arguments

ParameterDescription
identifierA unique identifier that represents a user in your system.
metaAdditional information about the user in your system.

Returns

Returns an object with a clientId property that can be used for requests.

Example Request

shell
curl "https://api.q2open.io/v1/client" \
  -H "Authorization: Bearer dc220490-e6ee-11e5-8a94-e7385a8d929e" \
  -H "Content-Type: application/json" \
  -d '{
    "identifier": "Bk0zwVx1Z",
    "meta": {
      "firstName": "Demo",
      "lastName": "User",
      "email": "demo@demo.com",
      "phone": "123-123-1234",
      "address1": "123 Api St.",
      "address2": "P.O. Box 283",
      "city": "Demo",
      "state": "Q2",
      "zipcode": "12345"
    }
  }'

Example Response

json
{
  "clientId": "579b695decfa11012711875d"
}