Workato · Agent Studio headless API

401 user_nonactive_or_missing (headless API)

Short answer

A 401 with error_code user_nonactive_or_missing means the X-IDP-User-Id header does not resolve to an active, allow-listed user. Confirm the user is active and belongs to an allow-listed user group.

VerifiedLast verified

01Error text

Workato error
"error_code": "user_nonactive_or_missing"

02Likely causes

  • The X-IDP-User-Id value does not resolve to an active, allow-listed user.
  • The same code is returned for a user that does not exist, a user not in an allow-listed user group, and an invited user who has not finished setup.

03How to fix it

  1. Look the user up with GET /api/iam/users?query=<email> and read the status field, which is active or invited.
  2. If the user is invited, have them finish setup.
  3. Add the user to an allow-listed user group.

04Official documentation

Test every fix in a non-production environment before you apply it to production. See how entries are verified.

More for Workato work:Open Workato jobsWorkato rates and salariesHire a senior Workato developer

The iPaaS Brief

Subscribe to The iPaaS Brief.

The iPaaS newsletter for the people who run integrations. From iPaaS Group.

Free. You finish on theipaasbrief.com and confirm by email.