Add an API User to a Project
Overview: add an API user to a project
For Developer READ and Developer READ-WRITE API keys, you must manually add the API user to each project the integration should access, which is used to keep API access limited to the projects you choose.
For creating keys and OAuth clients, see Set up API access.
- Your role must be project Manager or Admin.
- You can find the menu at Project Settings - Team or Users.
- This changes which projects the API user can read or write through the API.
Developer GLOBAL keys do not need per-project assignment.
How to add an API user to a project
- Open Project Settings for the target project.
- Go to the Team or Users section.
- Add the API user as a project member.
- Assign a project role (Viewer is usually sufficient for API use).
Results: API user project access
API key type | Project access requirement | Behavior |
|---|---|---|
Developer READ | Required | Can read data only from assigned projects |
Developer READ-WRITE | Required | Can read and write in assigned projects, and can assign itself to new ones |
Developer GLOBAL | Not required | Automatically has access to all projects |
Troubleshooting: add an API user to a project
Problem | Cause | Solution |
|---|---|---|
API user receives no data | API user not added to the project | Add the API user in Project Settings - Team or Users |
Access denied on API requests | Project role too low for the call, or wrong scope | Assign at least Viewer for read calls, or a higher role if the integration must write |
User not found in the dropdown | API user not created yet in company API settings | Create the API key or user in the company API area, then return to the project and add the user |
Updated on: 07/26/2026
Thank you!