> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.cxplanner.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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](https://help.cxplanner.com/en-us/article/set-up-api-access-sljl5q/).

* 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.

|| Only users with the project role **Manager** or **Admin** can add an API user to a project.

Developer GLOBAL keys do not need per-project assignment.

## How to add an API user to a project

1. Open **Project Settings** for the target project.
2. Go to the **Team** or **Users** section.
3. Add the **API user** as a project member.
4. Assign a project role (Viewer is usually sufficient for API use).

![Screenshot: Open project settings to manage team members](https://storage.crisp.chat/users/helpdesk/website/2196388214303400/bd86744e-f95b-4cd5-938f-ed994e_yg5lb4.jpeg)
![Screenshot: Add API user to the project team](https://storage.crisp.chat/users/helpdesk/website/5e76d3a500474800/a37c8e47-3d6a-4774-a56c-93c087_qn5vv6.jpeg)
![Screenshot: Confirm API user access on the project](https://storage.crisp.chat/users/helpdesk/website/3f0baa5ff44ab600/ecd6f9f4-ad06-41e5-b4c0-414843_oewkyg.jpeg)

## 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 |