Account and profile | Documentation Portal

Community Support Portal YouTube Start a free trial

Retrieving a customer profile

get

Retrieves a specified customer's profile.

customer.customer_read_own scope allows customers to read the specified profiles from another customers within the same company.

Required scopes

customer.customer_read
customer.customer_read_own

Authorizations

Path parameters

customerNumberstringRequired

Customer's unique identifier generated when the customer's profile is created.

tenantstringRequired

Your Emporix tenant's name.

Note: The tenant should always be written in lowercase.

Query parameters

expandstringOptional

List of additional attributes to be retrieved, separated by commas. Possible values to be passed in this parameter are:

addresses
accounts *mixin:* Order of the attributes has no influence on the response.

Responses

200

application/json

Responseall of

400

Request was syntactically incorrect. Details will be provided in the response payload.

application/json

401

Unauthorized

application/json

403

Given authorization scopes are not sufficient and do not match scopes required by the endpoint.

application/json

404

Customer with the specified `customerNumber` doesn't exist.

application/json

get

GET /customer/{tenant}/customers/{customerNumber} HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "title": "MR",
  "firstName": "John",
  "lastName": "Doe",
  "contactPhone": "123456789",
  "company": "Emporix",
  "preferredLanguage": "en_US",
  "preferredCurrency": "EUR",
  "preferredSite": "main",
  "metadata": {
    "version": 6
  },
  "customerNumber": "13869000",
  "id": "13869000",
  "contactEmail": "example@customer.com",
  "active": true,
  "onHold": false,
  "businessModel": "B2B",
  "b2b": {
    "companyRegistrationId": "123-456-789",
    "legalEntities": [
      {
        "id": "D165356",
        "name": "BMW",
        "contactAssignmentId": "D436432"
      }
    ]
  }
}

Deleting a customer profile

delete

Deletes a specified customer's profile and accounts associated with it.

customer.customer_manage_own scope allows customers to delete a customer only if the customer has been assigned to the same company.

Required scopes

customer.customer_manage
customer.customer_manage_own

Authorizations

Path parameters

customerNumberstringRequired

Customer's unique identifier generated when the customer's profile is created.

tenantstringRequired

Your Emporix tenant's name.

Note: The tenant should always be written in lowercase.

Responses

202

Accepted

400

Request was syntactically incorrect. Details will be provided in the response payload.

application/json

401

Unauthorized

application/json

403

Given authorization scopes are not sufficient and do not match scopes required by the endpoint.

application/json

404

Customer with the specified `customerNumber` doesn't exist.

application/json

delete

DELETE /customer/{tenant}/customers/{customerNumber} HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

No content

Retrieving a list of customers

get

Retrieves a list of customer profiles.

customer.customer_read_own scope allows customers to read profiles from another customers within the same company.

Required scopes

customer.customer_read
customer.customer_read_own

Authorizations

Path parameters

tenantstring · min: 3 · max: 16Required

Your Emporix tenant's name.

Note: The tenant should always be written in lowercase.

Pattern: ^[a-z][a-z0-9]+$

Query parameters

qstringOptional

A standard query parameter used to search for specific values.

Example: contactEmail:{email}

sortstringOptional

List of properties used to sort the results, separated by colons. Possible values:

{fieldName}
{fieldName}:asc
{fieldName}:desc

Note: If you want to sort the results by localized properties, the possible values are:

{fieldName}.{language}
{fieldName}.{language}:asc
{fieldName}.{language}:desc

By default, the fields are sorted in ascending order.

pageNumberinteger · min: 1Optional

Page number to be retrieved. The number of the first page is 1.

Note: If the pageNumber parameter is passed, size of the pages must be specified in the pageSize parameter.

Default: 1

pageSizeinteger · min: 1Optional

Number of customers to be retrieved per page.

Default: 60

expandstringOptional

List of additional attributes to be retrieved, separated by commas. Possible values to be passed in this parameter are:

addresses
accounts *mixin:* Order of the attributes has no influence on the response.

Responses

200

application/json

400

Request was syntactically incorrect. Details will be provided in the response payload.

application/json

401

Unauthorized

application/json

403

Given authorization scopes are not sufficient and do not match scopes required by the endpoint.

application/json

get

GET /customer/{tenant}/customers HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

[
  {
    "title": "MR",
    "firstName": "John",
    "lastName": "Doe",
    "contactPhone": "123456789",
    "company": "Emporix",
    "preferredLanguage": "en_US",
    "preferredCurrency": "EUR",
    "preferredSite": "main",
    "mixins": {},
    "metadata": {
      "mixins": {},
      "version": 6
    },
    "customerNumber": "13869000",
    "id": "13869000",
    "contactEmail": "example@customer.com",
    "active": true,
    "onHold": false,
    "businessModel": "B2B",
    "b2b": {
      "companyRegistrationId": "123-456-789",
      "legalEntities": [
        {
          "id": "D165356",
          "name": "BMW",
          "contactAssignmentId": "D436432"
        }
      ]
    }
  }
]

Creating a customer

post

Creates a new customer.

customer.customer_manage_own scope allow customers to create a new customer. Such customer will be automatically assigned to the customer's company.

Required scopes

customer.customer_manage
customer.customer_manage_own

Authorizations

Path parameters

tenantstring · min: 3 · max: 16Required

Your Emporix tenant's name.

Note: The tenant should always be written in lowercase.

Pattern: ^[a-z][a-z0-9]+$

Query parameters

sendPasswordResetNotificationsbooleanOptional

Flag indicating whether the customer should receive an email with a password reset link once their account is created.

Default: true

Body

all ofOptional

Responses

201

Created

application/json

400

Request was syntactically incorrect. Details will be provided in the response payload.

application/json

401

Unauthorized

application/json

403

Given authorization scopes are not sufficient and do not match scopes required by the endpoint.

application/json

409Error

application/json

post

POST /customer/{tenant}/customers HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 258

{
  "contactEmail": "john.doe@emporix.com",
  "title": "MR",
  "firstName": "John",
  "lastName": "Doe",
  "contactPhone": "123456789",
  "company": "Emporix",
  "preferredLanguage": "en_US",
  "preferredCurrency": "EUR",
  "preferredSite": "main",
  "b2b": {
    "companyRegistrationId": "123-456-789"
  }
}

{
  "id": "34751075"
}

Upserting a customer profile

put

Updates a specified customer's profile or creates a new one if it doesn't exist yet.

customer.customer_manage_own scope allows to update customer's profiles from the same company.

Required scopes

customer.customer_manage or customer.customer_manage_own

Authorizations

Path parameters

customerNumberstringRequired

Customer's unique identifier generated when the customer's profile is created.

tenantstringRequired

Your Emporix tenant's name.

Note: The tenant should always be written in lowercase.

Query parameters

sendPasswordResetNotificationsbooleanOptional

Flag indicating whether the customer should receive an email with a password reset link once their account is created.

Default: true

Body

all ofOptional

Responses

201

Created

application/json

204

No Content - update has been successful

400

Request was syntactically incorrect. Details will be provided in the response payload.

application/json

401

Unauthorized

application/json

403

Given authorization scopes are not sufficient and do not match scopes required by the endpoint.

application/json

409Error

application/json

put

PUT /customer/{tenant}/customers/{customerNumber} HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 39

{
  "contactEmail": "example@customer.com"
}

{
  "id": "34751075"
}

Updating a customer profile

patch

Updates a specified customer's profile.

customer.customer_manage_own scope allows to update customer's profiles from the same company.

Required scopes

customer.customer_manage
customer.customer_manage_own

Authorizations

Path parameters

customerNumberstringRequired

Customer's unique identifier generated when the customer's profile is created.

tenantstringRequired

Your Emporix tenant's name.

Note: The tenant should always be written in lowercase.

Body

all ofOptional

Responses

200

400

Request was syntactically incorrect. Details will be provided in the response payload.

application/json

401

Unauthorized

application/json

403

Given authorization scopes are not sufficient and do not match scopes required by the endpoint.

application/json

404

Customer with the specified `customerNumber` doesn't exist.

application/json

patch

PATCH /customer/{tenant}/customers/{customerNumber} HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 53

{
  "contactEmail": "example@customer.com",
  "active": true
}

No content

Assigning an account to an existing customer profile

post

Assigns a customer account to an existing customer profile.

Required scopes

customer.customer_manage

Authorizations

Path parameters

customerNumberstringRequired

Customer's unique identifier generated when the customer's profile is created.

tenantstringRequired

Your Emporix tenant's name.

Note: The tenant should always be written in lowercase.

Query parameters

sendPasswordResetNotificationsbooleanOptional

Flag indicating whether the customer should receive an email with a password reset link once their account is created.

Default: true

Body

emailstringRequired

Customer's email address.

Responses

201

Created

application/json

400

Request was syntactically incorrect. Details will be provided in the response payload.

application/json

401

Unauthorized

application/json

403

Given authorization scopes are not sufficient and do not match scopes required by the endpoint.

application/json

404

Customer with the specified `customerNumber` doesn't exist.

application/json

409Error

application/json

post

POST /customer/{tenant}/customers/{customerNumber}/accounts/internal HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_OAUTH2_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 32

{
  "email": "john.doe@example.com"
}

{
  "id": "13869000"
}