Skip to Content
Developers

Authentication

Create, use, store and rotate integration keys.

Every call carries a brand integration key as a bearer token:

Authorization: Bearer endvr_ik_live_...

Create a key

Coming with the Client API

The Other platforms card is not in the Brand Portal yet: today Brand Settings › Integrations only offers Shopify. It ships together with the Client API.

An Owner or Admin of the brand will create keys in the Brand Portal under Brand Settings › Integrations › Other platforms, choosing the e-commerce platform. The key is shown once: copy it into your secret manager right away. ENDVR only keeps a hash and can't show it again.

A key belongs to one brand and one connection. It is meant for servers: never put it in a browser, a mobile app or a public repository.

Test and live keys

PrefixModeWhat it does
endvr_ik_test_testWrites test data. Test redemptions are never billed and never open an associate's next code.
endvr_ik_live_liveWrites real data. Redemptions are billed according to your ENDVR plan.

GET /connection tells you which mode a key is in. See Test mode.

Rotate a key

Create a new key in the portal and deploy it. The old key keeps working for 24 hours after the rotation, so you can switch without downtime. Revoke a key immediately if it leaks.

Errors

A missing, unknown or revoked key answers 401 with an unauthorized problem.

On this page