Authorizes the current browser as an Employee Portal device for a store and writes the device cookie. Requires the "Employee Portal: Authorize and Revoke Devices" advanced permission.

​

Permissions: All users.

Headers

  • The Integration Key generated for API Authentication by the PAR OPS support team as part of the integration/partnership process.

Body·

  • Signed 32-bit integers (commonly used integer type).

Responses

Request Example for post/v2/devices/authorize
curl /v2/devices/authorize \
  --request POST \
  --header 'Content-Type: application/json-patch+json' \
  --header 'DCKey: YOUR_SECRET_TOKEN' \
  --data '{
  "StoreID": null,
  "DisplayName": null,
  "VisitorId": null
}'
{
  "ID": 1,
  "DisplayName": null,
  "StoreID": 1,
  "StoreName": null,
  "StoreNumber": null,
  "AuthorizedBy": null,
  "AuthorizedUtc": "2026-10-16T20:54:18.544Z",
  "ExpiresUtc": "2026-10-16T20:54:18.544Z",
  "LastValidatedUtc": null,
  "AuthorizedByName": null
}