API tokens

How to generate API token

Admin-level access permissions is required on your Constructor dashboard account to create an API Token. To do so, navigate to the Integration section, then select the API Integration tab, and click 'Generate API Token'.

Click "Display new token" - you may need to wait up to 5 minutes for the API token to take effect.

Using the Constructor API to send product data or control configurations such as synonyms, redirects, and searchandising rules, you'll need to authenticate your requests with an API token.

The API token is considered secret, and should only ever be sent via SSL to Constructor's API from back-end, secure servers. The API token should be treated like a password and carefully protected. On Constructor's side, the token is not stored in plain text, but as a one-way hash. Because of this, the token value cannot be viewed or retrieved by Constructor.

Note that you do not need an API Token to query and return Search, Autosuggest, Browse, and Recommendation requests.