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
"error_code": "user_nonactive_or_missing"02Likely causes
- The
X-IDP-User-Idvalue 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
- Look the user up with
GET /api/iam/users?query=<email>and read thestatusfield, which isactiveorinvited. - If the user is
invited, have them finish setup. - Add the user to an allow-listed user group.
04Official documentation
→Related errors
- 401 auth_failed (headless API)A 401 with error_code auth_failed from the headless API means the token in the request was not accepted. Check, in this order, the token type, the data center host, whether the key was rotated, and the Authorization header format.
- 401 UnauthorizedA 401 Unauthorized error in Workato means the external service rejected the authentication credentials sent with the request. Disconnect the app connection and reconnect it with valid, current credentials.
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