Credentials

Manage customer credentials.

Sending a request to update a customer email address

post

Sends a request to change a customer email address. As a result, the customer receives a unique token through email.

Note: The request needs to be authorized with a customer access token.


Required scopes

No specific scopes are required.

Request for changing login email token using current email id and password.

Requires scope customer.customerprofile_edit

Authorizations
AuthorizationstringRequired

To generate a customer access token, go to the 'Logging in a customer' endpoint.

Path parameters
tenantstring · min: 3 · max: 16Required

Your Emporix tenant name.

Note: The tenant should always be written in lowercase.

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

Customer email address currently used for logging in.

passwordstringOptional

Customer account password.

newEmailstringOptional

Customer new email address.

syncContactEmailbooleanOptional

Flag indicating whether the contactEmail should be changed to the new email address.

Default: false
Responses
post
/customer/{tenant}/me/accounts/internal/email/change
POST /customer/{tenant}/me/accounts/internal/email/change HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 114

{
  "email": "[email protected]",
  "password": "password123",
  "newEmail": "[email protected]",
  "syncContactEmail": true
}

No content

Updating a customer email address

post

Updates a customer email address using the token received through email.

Note: The request needs to be authorized with a anonymous access token.


Required scopes

No specific scopes are required.

Authorizations
AuthorizationstringRequired

To generate an anonymous token, check out the 'Requesting an anonymous token' endpoint.

Path parameters
tenantstringRequired

The tenant string is the project's Identifier from the Builder.

Body
tokenstringOptional

Token received by the customer through email.

Responses
post
/customer/{tenant}/me/accounts/internal/email/change/confirm
POST /customer/{tenant}/me/accounts/internal/email/change/confirm HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 76

{
  "token": "beExUmshJC5gnuXk1kET5dCLyQWkrAfKRGFOxVXLcJI13R1fn5USjaWku5G71whM"
}

No content

Sending a request to reset a customer password

post

Sends a request to reset a Customer account password. As a result, the customer receives a unique token through email.

Note: The request needs to be authorized with a anonymous access token.


Required scopes

No specific scopes are required.

Authorizations
AuthorizationstringRequired

To generate an anonymous token, check out the 'Requesting an anonymous token' endpoint.

Path parameters
tenantstring · min: 3 · max: 16Required

Your Emporix tenant name.

Note: The tenant should always be written in lowercase.

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

Customer email address.

sitestringOptional

Site from which password reset request was sent

Responses
post
/customer/{tenant}/password/reset
POST /customer/{tenant}/password/reset HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 32

{
  "email": "[email protected]"
}

No content

Resetting a customer password

post

Resets a customer password using the token received through email and sets a new password.

Note: The request needs to be authorized with a anonymous access token.


Required scopes

No specific scopes are required.

Authorizations
AuthorizationstringRequired

To generate an anonymous token, check out the 'Requesting an anonymous token' endpoint.

Path parameters
tenantstring · min: 3 · max: 16Required

Your Emporix tenant name.

Note: The tenant should always be written in lowercase.

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

Token received by the customer through email.

passwordstringRequired

Customer new account password.

Responses
post
/customer/{tenant}/password/reset/update
POST /customer/{tenant}/password/reset/update HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 101

{
  "token": "beExUmshJC5gnuXk1kET5dCLyQWkrAfKRGFOxVXLcJI13R1fn5USjaWku5G71whM",
  "password": "P@ssw0rd123"
}

No content

Changing a customer password

post

Changes a Customer account password.

Note: The request needs to be authorized with a customer access token.


Required scopes

No specific scopes are required.

Authorizations
AuthorizationstringRequired

To generate a customer access token, go to the 'Logging in a customer' endpoint.

Path parameters
tenantstring · min: 3 · max: 16Required

Your Emporix tenant name.

Note: The tenant should always be written in lowercase.

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

Customer current account password.

newPasswordstringRequired

Customer new account password.

Responses
post
/customer/{tenant}/password/change
POST /customer/{tenant}/password/change HTTP/1.1
Host: api.emporix.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 61

{
  "currentPassword": "password123",
  "newPassword": "P@ssw0rd123"
}

No content

Last updated

Was this helpful?