Heads up, our devs are blazing ahead—docs are catching up, so some features might not be fully documented yet.
Visit our websiteAPI Documentation

User

User

Get full account info

get

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

Authorizations
Responses
200

User account response

application/json
get
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-09-12T13:26:18.678Z",
      "defaultStoreUid": "text",
      "displayName": "text",
      "email": "text",
      "externalId": "text",
      "firstname": "text",
      "lastAccessed": "2025-09-12T13:26:18.678Z",
      "lastModifiedAt": "2025-09-12T13:26:18.678Z",
      "lastname": "text",
      "mobile": "text",
      "status": "PENDING_INVITE",
      "storeAccess": [
        {
          "createdAt": "2025-09-12T13:26:18.678Z",
          "lastModifiedAt": "2025-09-12T13:26:18.678Z",
          "storeAccessUid": "text",
          "storeUid": "text",
          "storeRole": "ADMIN"
        }
      ],
      "tenantUid": "text",
      "tenantRole": "ACCESS",
      "tenantUserUid": "text",
      "userCode": "text",
      "languageCode": "text"
    }
  ]
}

Login user

post

Login as a tenant user

Requires a valid deviceToken

Authorizations
Body
passwordstringRequired
userCodestringRequired
Responses
200

Example response

application/json
post
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-09-12T13:26:18.678Z",
    "defaultStoreUid": "text",
    "displayName": "text",
    "email": "text",
    "externalId": "text",
    "firstname": "text",
    "lastAccessed": "2025-09-12T13:26:18.678Z",
    "lastModifiedAt": "2025-09-12T13:26:18.678Z",
    "lastname": "text",
    "mobile": "text",
    "status": "PENDING_INVITE",
    "storeAccess": [
      {
        "createdAt": "2025-09-12T13:26:18.678Z",
        "lastModifiedAt": "2025-09-12T13:26:18.678Z",
        "storeAccessUid": "text",
        "storeUid": "text",
        "storeRole": "ADMIN"
      }
    ],
    "tenantUid": "text",
    "tenantRole": "ACCESS",
    "tenantUserUid": "text",
    "userCode": "text",
    "languageCode": "text"
  }
}

Update global account information

put

Update global information about logged in user

Authorizations
Body
defaultTenantUidstringRequiredPattern: ^[A-Za-z0-9-_]+
Responses
200

User account response

application/json
put
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-09-12T13:26:18.678Z",
      "defaultStoreUid": "text",
      "displayName": "text",
      "email": "text",
      "externalId": "text",
      "firstname": "text",
      "lastAccessed": "2025-09-12T13:26:18.678Z",
      "lastModifiedAt": "2025-09-12T13:26:18.678Z",
      "lastname": "text",
      "mobile": "text",
      "status": "PENDING_INVITE",
      "storeAccess": [
        {
          "createdAt": "2025-09-12T13:26:18.678Z",
          "lastModifiedAt": "2025-09-12T13:26:18.678Z",
          "storeAccessUid": "text",
          "storeUid": "text",
          "storeRole": "ADMIN"
        }
      ],
      "tenantUid": "text",
      "tenantRole": "ACCESS",
      "tenantUserUid": "text",
      "userCode": "text",
      "languageCode": "text"
    }
  ]
}

Get account info for a specific tenant

get

Get tenant information about logged-in user

Authorizations
Path parameters
tenantUidstringRequired

Reference to a tenant.

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

Tenant user respose

application/json
get
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-09-12T13:26:18.678Z",
  "defaultStoreUid": "text",
  "displayName": "text",
  "email": "text",
  "externalId": "text",
  "firstname": "text",
  "lastAccessed": "2025-09-12T13:26:18.678Z",
  "lastModifiedAt": "2025-09-12T13:26:18.678Z",
  "lastname": "text",
  "mobile": "text",
  "status": "PENDING_INVITE",
  "storeAccess": [
    {
      "createdAt": "2025-09-12T13:26:18.678Z",
      "lastModifiedAt": "2025-09-12T13:26:18.678Z",
      "storeAccessUid": "text",
      "storeUid": "text",
      "storeRole": "ADMIN"
    }
  ],
  "tenantUid": "text",
  "tenantRole": "ACCESS",
  "tenantUserUid": "text",
  "userCode": "text",
  "languageCode": "text"
}

Generate accessToken from authToken

post

Generate access token from auth token

Authorizations
Path parameters
tenantUidstringRequired

Reference to a tenant.

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

Tenant user respose

application/json
post
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-09-12T13:26:18.678Z",
  "defaultStoreUid": "text",
  "displayName": "text",
  "email": "text",
  "externalId": "text",
  "firstname": "text",
  "lastAccessed": "2025-09-12T13:26:18.678Z",
  "lastModifiedAt": "2025-09-12T13:26:18.678Z",
  "lastname": "text",
  "mobile": "text",
  "status": "PENDING_INVITE",
  "storeAccess": [
    {
      "createdAt": "2025-09-12T13:26:18.678Z",
      "lastModifiedAt": "2025-09-12T13:26:18.678Z",
      "storeAccessUid": "text",
      "storeUid": "text",
      "storeRole": "ADMIN"
    }
  ],
  "tenantUid": "text",
  "tenantRole": "ACCESS",
  "tenantUserUid": "text",
  "userCode": "text",
  "languageCode": "text"
}

Update account info

put

Update information about logged in user

Authorizations
Path parameters
tenantUidstringRequired

Reference to a tenant.

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

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
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-09-12T13:26:18.678Z",
  "defaultStoreUid": "text",
  "displayName": "text",
  "email": "text",
  "externalId": "text",
  "firstname": "text",
  "lastAccessed": "2025-09-12T13:26:18.678Z",
  "lastModifiedAt": "2025-09-12T13:26:18.678Z",
  "lastname": "text",
  "mobile": "text",
  "status": "PENDING_INVITE",
  "storeAccess": [
    {
      "createdAt": "2025-09-12T13:26:18.678Z",
      "lastModifiedAt": "2025-09-12T13:26:18.678Z",
      "storeAccessUid": "text",
      "storeUid": "text",
      "storeRole": "ADMIN"
    }
  ],
  "tenantUid": "text",
  "tenantRole": "ACCESS",
  "tenantUserUid": "text",
  "userCode": "text",
  "languageCode": "text"
}

Get tenant invitation information

get

Get information about invitation to a tenant

Header parameters
x-invite-tokenstringRequired

invite token

Responses
200

Example response

application/json
get
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

Accept invitation to a tenant

Authorizations
Body

Accept an invitation

inviteTokenstringRequired
Responses
200

Tenant user respose

application/json
put
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-09-12T13:26:18.678Z",
  "defaultStoreUid": "text",
  "displayName": "text",
  "email": "text",
  "externalId": "text",
  "firstname": "text",
  "lastAccessed": "2025-09-12T13:26:18.678Z",
  "lastModifiedAt": "2025-09-12T13:26:18.678Z",
  "lastname": "text",
  "mobile": "text",
  "status": "PENDING_INVITE",
  "storeAccess": [
    {
      "createdAt": "2025-09-12T13:26:18.678Z",
      "lastModifiedAt": "2025-09-12T13:26:18.678Z",
      "storeAccessUid": "text",
      "storeUid": "text",
      "storeRole": "ADMIN"
    }
  ],
  "tenantUid": "text",
  "tenantRole": "ACCESS",
  "tenantUserUid": "text",
  "userCode": "text",
  "languageCode": "text"
}
PreviousTimeslotsNextWarehouse

Was this helpful?