Workspace owners, use audit logs to help troubleshoot situations like mistakes, bad actors, and malicious actions. 

Feature availability and limits vary by plan and user role. Learn more.

API integration

Integrate your audit log with your external systems or export logs to use as a reference for compliance via our API. 

Events tracked by audit logs 

Events are user actions that are logged. There are four logs:

• User: The user log tracks authentication and authorization events, like user logins and logouts, role changes, and user invites.
• Task: The task log tracks selected task activity by user and task activity type. 
• Fields: The Fields log tracks Custom Field events, like Custom Fields being created or removed. 
• Hierarchy: The Hierarchy log tracks Hierarchy events, like a Folder being created or a List being deleted. 

Event data

The logs generate the following data for every event:

• Date
• User
• Role
• Event
• Status

An event log provides more detail. To view the event log:

• To the left of the date in any row of the audit log, click the dropdown.

The event log is an internal reporting system that uses our naming schemas. Some info, like user roles, is represented by a number.

The following table shows example event log data generated when an admin successfully logs in via 2FA:

Events tracked by the user log

The following table details the events tracked by the user log:

Events tracked by the task log

The following table lists the events tracked by the task log:

Events tracked by the Fields log

The following table lists the events tracked by the Fields log:

Events tracked by the Hierarchy log

The following table lists the events tracked by the Hierarchy log:

Access your audit logs

Audit Logs are generated in your ClickUp Workspace settings and can also be used with the ClickUp API. 

To access audit logs from ClickUp:

1. In the upper-left corner, click your Workspace avatar. 
2. Select Audit Logs.
3. Click the User or Task tab to select a log.

Search your audit logs

From the Audit Logs modal in your Workspace settings, you can search both logs using the following filters:

Date

The date the event happened. To search by date:

1. Select the User or Task tab.
2. Below the tabs, select the Date dropdown.
3. From the date picker, choose one or both options:
   • From date: When the event started.
   • To date: When the event ended.

User

The user who performed the action. To search by user:

1. Select the User or Task tab.
2. Below the tabs, select the User dropdown.
3. From the people selector, choose a user. 

Status

The status of the completed action. For example, success or error. To view 

1. Select the User or Task tab.
2. Below the tabs, select the Status dropdown.
3. From the dropdown, select one or more of the following statuses:
   • Success
   • Failed 

Allow admins to view audit logs

Owners can permit admins to view audit logs. Members and guests cannot view audit logs.

To permit admins to view logs:

1. In the upper-left corner, click your Workspace avatar.
2. Select Settings.
3. Select Security & Permissions. 
4. Create a custom permission that inherits the admin role. 
5. Scroll down to the Workspace Actions section.
6. In the new role's column click the View Audit Logs toggle to on.