How do we find staff id from admin?

GraphQL Admin API Troubleshooting
1

Our app use the POS staff member id (from session API) to set some of the app’s function permissions. We are not trying to get information with read_users scope.

In admin, we used to be able to determine the staff id from the URL linked from the staff page.

image
image228×153 2.49 KB

image

This page has now been removed from the admin and has been combined with users in settings. Can you please let us know how we can access the staff member id now?

2

Hi @hmpws

You’re right that the old /admin/settings/account/{id} URL no longer exposes the staff member ID directly. The best way to get staff IDs now is through the GraphQL Admin API using the staffMembers query:

query {
  staffMembers(first: 50) {
    edges {
      node {
        id
        name
        email
        active
      }
    }
  }
}

This returns globally-unique IDs like gid://shopify/StaffMember/12345 — the numeric portion (12345) is the same value that the POS Session API returns as staffMemberId. So you can use this query to build a mapping of staff names/emails to their numeric IDs for your app’s permission setup.

A couple of things to note:

  • This query requires the read_users scope, which is only available on Shopify Plus and Advanced plans. If your merchants are on those plans, this is the straightforward path.
  • If you’re only needing the ID for the currently pinned staff member during a POS session, you already have it via the Session API’s staffMemberId — no additional scopes needed.

For merchants on lower plans without access to read_users, one workaround is to have the app collect and store the staffMemberId from POS sessions as each staff member pins in, building up your own staff roster over time.