Skip to main content
Nintex Community Menu Bar
Question

Need help: 403 Forbidden Error (/tenants) when creating Nintex Workflow users via API

  • June 16, 2026
  • 8 replies
  • 48 views

Forum|alt.badge.img+2

Hi everyone,

I want to use the Nintex API to create multiple users at once.

I am using the Create User endpoint: POST /usermanagement/v1/tenants/{tenantId}/users

However, I cannot get it to work. I keep getting this error when I try:

JSON

{
"type": "https://tools.ietf.org/html/rfc9110#section-15.5.4",
"title": "Forbidden",
"status": 403,
"detail": "Forbidden",
"instance": "/tenants"
}

 

 i have provided the token that is global administrator role. Which it still not allow to create.

 

I have a questions:

Is there anyone use different method to batch create Nintex Workflow Users?

 

Thank you for your help!

8 replies

Simon Muntz
Nintex Partner
Forum|alt.badge.img+23
  • Nintex Partner
  • June 16, 2026

Hi ​@yonghua.poh,

Can you provide a link to the API documentation you are using?
The reason I ask is that to create users in Nintex Workflow Cloud, the endpoint looks like: 

https://us.nintex.io/tenants/v1/users


Forum|alt.badge.img+2
  • Author
  • Nintex Partner
  • June 16, 2026

Forum|alt.badge.img+11
  • Nintex Employee
  • June 16, 2026

Hi ​@yonghua.poh 

Make sure your Authorization header is configured like this:

Authorization: Bearer YOUR_TOKEN_HERE

If you left the Bearer prefix out of your token it would throw an error like this.


Simon Muntz
Nintex Partner
Forum|alt.badge.img+23
  • Nintex Partner
  • June 16, 2026

Hi ​@yonghua.poh,

To answer your other question about the best way to batch-create users. The best way is to configure SSO for the tenant. That way, any user who logs in automatically gets added to the tenant with the Participant role.


Forum|alt.badge.img+2
  • Author
  • Nintex Partner
  • June 19, 2026

Hi ​@yonghua.poh 

Make sure your Authorization header is configured like this:

Authorization: Bearer YOUR_TOKEN_HERE

If you left the Bearer prefix out of your token it would throw an error like this.

I using tool provided in the developer.nintex.com, it says forbidden.

 

 


Forum|alt.badge.img+2
  • Author
  • Nintex Partner
  • June 19, 2026

Hi ​@yonghua.poh,

To answer your other question about the best way to batch-create users. The best way is to configure SSO for the tenant. That way, any user who logs in automatically gets added to the tenant with the Participant role.

Yes, let’s say the business manager user wanted to assign the user to specific business role in advanced, when he/she try to assign the role, nintex system unable to find these user due to not in the Nintex Workflow User management yet.

For example, below is the business user role to assign to user. This build from Nintex App, currnetly the email dropdownlist i pull from the list of nintex users. Actually i can pull from the business table (which i have all list of business users). But if the nintex workflow is started and the user not yet login via SSO, the workflow surely failed.



 


Simon Muntz
Nintex Partner
Forum|alt.badge.img+23
  • Nintex Partner
  • June 19, 2026

Hi ​@yonghua.poh,

Have you tried adding a user from the company domain?
The error may be stemming from the hotmail.com domain being used.
If you tried adding this user from the GUI, you would most likely see an error.


Forum|alt.badge.img+2
  • Author
  • Nintex Partner
  • June 19, 2026

yeah, also same error.

 

hmmm… maybe if the user not being created in the Nintex Workflow User management, but i have the User Directory Lookup connected, maybe it wont fail in Assign User Task. I will check and see.