User

User

Get full account info

get

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/account

Get full account information for a logged-in user. This will return information for all tenants the user has access to.

Authorizations

accessTokenauthTokenintegrationToken

AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Responses

200

User account response

application/json

get

/account

HTTPcURLJavaScriptPython

GET /v2/account HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

User account response

{
  "globalRoles": [
    "text"
  ],
  "defaultTenantUid": "text",
  "tenants": [
    {
      "accountType": "FULL",
      "createdAt": "2025-12-14T03:03:41.679Z",
      "defaultStoreUid": "text",
      "displayName": "text",
      "email": "text",
      "externalId": "text",
      "firstname": "text",
      "lastAccessed": "2025-12-14T03:03:41.679Z",
      "lastModifiedAt": "2025-12-14T03:03:41.679Z",
      "lastname": "text",
      "mobile": "text",
      "status": "PENDING_INVITE",
      "storeAccess": [
        {
          "createdAt": "2025-12-14T03:03:41.679Z",
          "lastModifiedAt": "2025-12-14T03:03:41.679Z",
          "storeAccessUid": "text",
          "storeUid": "text",
          "storeRole": "ADMIN"
        }
      ],
      "tenantUid": "text",
      "tenantRole": "ACCESS",
      "tenantUserUid": "text",
      "userCode": "text",
      "languageCode": "text"
    }
  ]
}

Login user

post

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/account

Login as a tenant user

Requires a valid deviceToken

Authorizations

deviceToken

AuthorizationstringRequired

The devicetoken is only used for to attach devices and tie it to a tenant

Body

application/json

passwordstringRequired

userCodestringRequired

Responses

200

Example response

application/json

post

/account

HTTPcURLJavaScriptPython

POST /v2/account HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 37

{
  "password": "text",
  "userCode": "text"
}

200

Example response

{
  "accessToken": "text",
  "tenantUser": {
    "accountType": "FULL",
    "createdAt": "2025-12-14T03:03:41.679Z",
    "defaultStoreUid": "text",
    "displayName": "text",
    "email": "text",
    "externalId": "text",
    "firstname": "text",
    "lastAccessed": "2025-12-14T03:03:41.679Z",
    "lastModifiedAt": "2025-12-14T03:03:41.679Z",
    "lastname": "text",
    "mobile": "text",
    "status": "PENDING_INVITE",
    "storeAccess": [
      {
        "createdAt": "2025-12-14T03:03:41.679Z",
        "lastModifiedAt": "2025-12-14T03:03:41.679Z",
        "storeAccessUid": "text",
        "storeUid": "text",
        "storeRole": "ADMIN"
      }
    ],
    "tenantUid": "text",
    "tenantRole": "ACCESS",
    "tenantUserUid": "text",
    "userCode": "text",
    "languageCode": "text"
  }
}

Update global account information

put

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/account

Update global information about logged in user

Authorizations

accessTokenauthTokenintegrationToken

AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Body

application/json

defaultTenantUidstringRequiredPattern: ^[A-Za-z0-9-_]+

Responses

200

User account response

application/json

put

/account

HTTPcURLJavaScriptPython

PUT /v2/account HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 27

{
  "defaultTenantUid": "text"
}

200

User account response

{
  "globalRoles": [
    "text"
  ],
  "defaultTenantUid": "text",
  "tenants": [
    {
      "accountType": "FULL",
      "createdAt": "2025-12-14T03:03:41.679Z",
      "defaultStoreUid": "text",
      "displayName": "text",
      "email": "text",
      "externalId": "text",
      "firstname": "text",
      "lastAccessed": "2025-12-14T03:03:41.679Z",
      "lastModifiedAt": "2025-12-14T03:03:41.679Z",
      "lastname": "text",
      "mobile": "text",
      "status": "PENDING_INVITE",
      "storeAccess": [
        {
          "createdAt": "2025-12-14T03:03:41.679Z",
          "lastModifiedAt": "2025-12-14T03:03:41.679Z",
          "storeAccessUid": "text",
          "storeUid": "text",
          "storeRole": "ADMIN"
        }
      ],
      "tenantUid": "text",
      "tenantRole": "ACCESS",
      "tenantUserUid": "text",
      "userCode": "text",
      "languageCode": "text"
    }
  ]
}

Get account info for a specific tenant

get

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/tenants/{tenantUid}/account

Get tenant information about logged-in user

Authorizations

accessTokenauthTokenintegrationToken

AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters

tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

Responses

200

Tenant user respose

application/json

get

/tenants/{tenantUid}/account

HTTPcURLJavaScriptPython

GET /v2/tenants/{tenantUid}/account HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Tenant user respose

{
  "accountType": "FULL",
  "createdAt": "2025-12-14T03:03:41.679Z",
  "defaultStoreUid": "text",
  "displayName": "text",
  "email": "text",
  "externalId": "text",
  "firstname": "text",
  "lastAccessed": "2025-12-14T03:03:41.679Z",
  "lastModifiedAt": "2025-12-14T03:03:41.679Z",
  "lastname": "text",
  "mobile": "text",
  "status": "PENDING_INVITE",
  "storeAccess": [
    {
      "createdAt": "2025-12-14T03:03:41.679Z",
      "lastModifiedAt": "2025-12-14T03:03:41.679Z",
      "storeAccessUid": "text",
      "storeUid": "text",
      "storeRole": "ADMIN"
    }
  ],
  "tenantUid": "text",
  "tenantRole": "ACCESS",
  "tenantUserUid": "text",
  "userCode": "text",
  "languageCode": "text"
}

Generate accessToken from authToken

post

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/tenants/{tenantUid}/account

Generate access token from auth token

Authorizations

authToken

AuthorizationstringRequired

Token received from the auth service

Path parameters

tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

Responses

200

Tenant user respose

application/json

post

/tenants/{tenantUid}/account

HTTPcURLJavaScriptPython

POST /v2/tenants/{tenantUid}/account HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Tenant user respose

{
  "accountType": "FULL",
  "createdAt": "2025-12-14T03:03:41.679Z",
  "defaultStoreUid": "text",
  "displayName": "text",
  "email": "text",
  "externalId": "text",
  "firstname": "text",
  "lastAccessed": "2025-12-14T03:03:41.679Z",
  "lastModifiedAt": "2025-12-14T03:03:41.679Z",
  "lastname": "text",
  "mobile": "text",
  "status": "PENDING_INVITE",
  "storeAccess": [
    {
      "createdAt": "2025-12-14T03:03:41.679Z",
      "lastModifiedAt": "2025-12-14T03:03:41.679Z",
      "storeAccessUid": "text",
      "storeUid": "text",
      "storeRole": "ADMIN"
    }
  ],
  "tenantUid": "text",
  "tenantRole": "ACCESS",
  "tenantUserUid": "text",
  "userCode": "text",
  "languageCode": "text"
}

Update account info

put

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/tenants/{tenantUid}/account

Update information about logged in user

Authorizations

accessTokenauthTokenintegrationToken

AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters

tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

Body

application/json

Update the tenant account

defaultStoreUidstringOptionalPattern: ^[A-Za-z0-9-_]*

displayNamestringOptional

emailstringOptional

firstnamestringOptional

lastnamestringOptional

mobilestringOptional

passwordstringOptional

languageCodestringOptional

ISO 639-1 code for language

Responses

200

Tenant user respose

application/json

put

/tenants/{tenantUid}/account

HTTPcURLJavaScriptPython

PUT /v2/tenants/{tenantUid}/account HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 155

{
  "defaultStoreUid": "text",
  "displayName": "text",
  "email": "text",
  "firstname": "text",
  "lastname": "text",
  "mobile": "text",
  "password": "text",
  "languageCode": "text"
}

200

Tenant user respose

{
  "accountType": "FULL",
  "createdAt": "2025-12-14T03:03:41.679Z",
  "defaultStoreUid": "text",
  "displayName": "text",
  "email": "text",
  "externalId": "text",
  "firstname": "text",
  "lastAccessed": "2025-12-14T03:03:41.679Z",
  "lastModifiedAt": "2025-12-14T03:03:41.679Z",
  "lastname": "text",
  "mobile": "text",
  "status": "PENDING_INVITE",
  "storeAccess": [
    {
      "createdAt": "2025-12-14T03:03:41.679Z",
      "lastModifiedAt": "2025-12-14T03:03:41.679Z",
      "storeAccessUid": "text",
      "storeUid": "text",
      "storeRole": "ADMIN"
    }
  ],
  "tenantUid": "text",
  "tenantRole": "ACCESS",
  "tenantUserUid": "text",
  "userCode": "text",
  "languageCode": "text"
}

Get tenant invitation information

get

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/account/invite

Get information about invitation to a tenant

Header parameters

x-invite-tokenstringRequired

invite token

Responses

200

Example response

application/json

get

/account/invite

HTTPcURLJavaScriptPython

GET /v2/account/invite HTTP/1.1
Host: api.flowretail.com
x-invite-token: text
Accept: */*

200

Example response

{
  "tenant": {
    "name": "text"
  },
  "user": {
    "displayName": "text",
    "email": "text",
    "firstname": "text",
    "lastname": "text",
    "mobile": "text",
    "status": "text"
  }
}

Accept tenant invitation

put

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/account/invite

Accept invitation to a tenant

Authorizations

authToken

AuthorizationstringRequired

Token received from the auth service

Body

application/json

Accept an invitation

inviteTokenstringRequired

Responses

200

Tenant user respose

application/json

put

/account/invite

HTTPcURLJavaScriptPython

PUT /v2/account/invite HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 22

{
  "inviteToken": "text"
}

200

Tenant user respose

{
  "accountType": "FULL",
  "createdAt": "2025-12-14T03:03:41.679Z",
  "defaultStoreUid": "text",
  "displayName": "text",
  "email": "text",
  "externalId": "text",
  "firstname": "text",
  "lastAccessed": "2025-12-14T03:03:41.679Z",
  "lastModifiedAt": "2025-12-14T03:03:41.679Z",
  "lastname": "text",
  "mobile": "text",
  "status": "PENDING_INVITE",
  "storeAccess": [
    {
      "createdAt": "2025-12-14T03:03:41.679Z",
      "lastModifiedAt": "2025-12-14T03:03:41.679Z",
      "storeAccessUid": "text",
      "storeUid": "text",
      "storeRole": "ADMIN"
    }
  ],
  "tenantUid": "text",
  "tenantRole": "ACCESS",
  "tenantUserUid": "text",
  "userCode": "text",
  "languageCode": "text"
}