Connect
1
Generate a ClickUp Personal API Token
In ClickUp, go to Settings → Apps, then click Generate under API Token. Copy the token.
2
Open AgentWeb's ClickUp settings
In the portal, go to Brand → Knowledge Base and find the ClickUp section. Click Connect.
3
Paste the token
Paste the ClickUp Personal API Token into the field and click Save. AgentWeb verifies the token and displays your connected workspaces.
What Emma can do
Emma uses these capabilities automatically during conversations when ClickUp content is relevant. You can also ask explicitly: “Search my ClickUp docs for our positioning statement.”
Security
- Your API token is encrypted at rest using per-user encryption. It is never stored in plaintext.
- The token is decrypted only at the moment of an API call. All communication with ClickUp uses HTTPS.
- Each user’s token is isolated. One user cannot access another user’s documents through AgentWeb.
- If the token expires or is revoked in ClickUp, AgentWeb detects it and marks the account as disconnected.
Disconnect
Go to Brand → Knowledge Base → ClickUp and click Disconnect. The stored token is removed immediately. Your ClickUp data is not affected — AgentWeb only reads documents, never writes.Troubleshooting
Invalid token error
Invalid token error
The token must be a ClickUp Personal API Token, not an OAuth client secret or app token. Generate at ClickUp → Settings → Apps → API Token → Generate.
Emma can't find documents I know exist
Emma can't find documents I know exist
Check that the workspaces shown after connection actually contain the documents. The token’s scope is whatever the user who generated it has access to in ClickUp.
Account shows disconnected after a while
Account shows disconnected after a while
Personal API Tokens can be revoked in ClickUp’s settings. Re-generate the token in ClickUp and reconnect in AgentWeb.

