Skip to content

Customer keys migration

Due to customer key format restrictions, the old Web API v1 customerKey can be unsuitable for use with the Web API v2. For Elevate 3 Enterprise to connect session data for the old customerKey with the new UUID v4 key, both keys can be either used together in the same session or migrated explicitly for a market using Customer keys migration. Multiple keys can be migrated simultaneously within a market.



URL format



Name Type Description Example
market string The market used for key migration. Sweden
oldKey string The old Web API v1 customerKey. 5G7HJ...R77T1
newKey string The new Web API v2 esales.customerKey. A UUID v4 / GUID. f6e1f...06692e

Required headers

The header Api-Key is required.

Request body

    { "oldKey" : "string", "newKey" : "string" }

Request content-type


Response content-type



Response Description
204 The migration completed successfully.
4xx The request made by the client was invalid. The response body may contain more information about the error.
5xx Server error such as cluster unavailable or busy. The response body may contain more information about the error.




    { "oldKey" : "user1", "newKey" : "f6e1fc35-9db9-4457-b8a9-9b85a506692e" },
    { "oldKey" : "user2", "newKey" : "2a7a953f-fe66-40b7-ae19-da8d1e06374f" },
    { "oldKey" : "userN", "newKey" : "c2488de3-1355-4c76-98a2-3265f2545c3a" }


curl -i \
-T customer-keys-binding.json \
-H "Content-Type: application/json" \
-H "Api-Key: {PRIVATE-KEY}" \


HTTP/2 204 No Content

This online publication is intellectual property of Voyado Lund AB. Its contents can be duplicated in part or whole, provided that a copyright label is visibly located on each copy and the copy is used in conjunction with the product described within this document.

All information found in these documents has been compiled with utmost attention to detail. However, this does not guarantee complete accuracy. Neither Voyado Lund AB nor the authors shall be held liable for possible errors or the consequences thereof.

Software and hardware descriptions cited in these documents might be registered trademarks. All trade names are subject to copyright restrictions and may be registered trademarks. Voyado Lund AB essentially adheres to the manufacturer’s spelling. Names of products and trademarks appearing in this document, with or without specific notation, are likewise subject to trademark and trade protection laws and may thus fall under copyright restrictions.