# Activity Audit Log

WHO CAN USE THIS FEATURE?

The Activity audit log is an add-on feature. Reach out to your Customer Success Manager for more info.

Administration and user management are must-haves for any integration project, big or small. As team size and complexity grows around your projects, control and activity visibility within your Workato workspace will become critical.

With Activity audit logs, you can view changes made by users in your account over time.

In this guide, we'll cover:


# Basics

# What is the activity audit log?

Activity audit logs provide a simple, powerful interface for Workato administrators to comprehensively track changes in their accounts. These changes include user activity such as logins and invitations, recipe modifications and events, and more.

# How can I use activity audit logs?

Using activity audit logs, you can quickly identify changes made in your account and analyze their impact.

For example: Imagine there was an unplanned stoppage of a business-critical recipe that onboards new employees. Using Activity audit logs, you can identify when the recipe was stopped and the user that stopped it.

# How do I get the activity audit log feature?

The Activity audit log feature is an add-on. Reach out to your Workato Customer Success Manager for more info.

# What activities are included?

Refer to the Activity reference section for a comprehensive list of activities included in the Activity audit log.

# How long are logs retained?

By default, Activity audit logs are retained for one year from the event. To inquire about a longer retention period, reach out to your Workato Customer Success Manager.

You can also use the Audit log streaming feature to replicate log data to your destination of choice.

# Who can view activity audit logs?

Once enabled, the following users can view Activity audit logs:

  • The account owner
  • Users with the Admin role
  • Users with the Activity audit privilege

# Viewing Activity Audit Logs

Users with the required access can view Audit activity logs by navigating to Dashboard > Activity audit.

Use the filters at the top of the page to filter logs based on selected criteria. For example: To view a specific user's activities, click All users and select the user from the menu.


# Streaming Activity Audit Logs

To ensure logs are retained according to your needs, we recommend using the Activity log streaming feature.

When configured, this feature streams audit log data to the destination of your choice. Refer to the Audit log streaming guide for more info.


# Activity Reference

This section contains the names and descriptions of activities included in activity audit logs. Activities are grouped by category - for example, Account, Connection, etc.

# Account Activities

Activities related to the Workato account, including user logins, password and email changes, and account setting modifications.

Activity Description
User login User logged in through SSO or using a password. See an example.
User login failed User login attempt failed. Select the activity to find out if the user was logging in through SSO or using a password. See an example.
User logout User logged out of Workato.
Password changed User changed their password by going to Account Settings > Change password.
User switched team User switched to another team account. In audit logs for the account the user switched to, this is shown as User login. Select the activity to view the value of the Activity attribute in the details section; a value of switch_team indicates the user switched to another team.
Account email updated User updated their email by going to Account Settings > Account and modifying the Account email field.
User name updated User updated their username by going to Account Settings > Profile and modifying the Username field.
Password reset requested User requested to reset their password by clicking Forgot password? during login. In the next screen, by providing the email and clicking the Reset password user confirms the intent to reset their password.
Delegated admin added User gave another Workato user delegated administration access by going to Account Settings > Delegated administrator.
Delegated admin password updated User changed their delegated administrator password by going to Account Settings > Change password > Delegated administrator password and updating it with a new password.
Delegated admin removed User removed another Workato user's delegated administration access by going to Account Settings > Delegated administrator.
Enabled two-factor authentication User enabled two-factor authentication by going to Account Settings > Two-Factor Authentication.
Disabled two-factor authentication User disabled two-factor authentication by going to Account Settings > Two-Factor Authentication and clicking Disable Two-Factor Authentication.
Viewed two-factor authentication recovery codes User viewed the two-factor authentication recovery codes by going to Account Settings > Two-Factor Authentication and clicking View recovery codes.
API key refreshed User refreshed the API key used to connect to Workato platform APIs by going to Account Settings > API key and clicking Refresh key.
Error notifications email updated User updated the list of emails receiving error notifications from Workato by going to Account Settings > Jobs settings and entering emails in the Error notifications field.
Error notification throttling User enabled or disabled notification throttling by going to Account Settings > Jobs settings and toggling the Error notification throttling checkbox.
Audit log streaming User enabled or disabled audit log streaming by going to Account Settings > Audit log streaming and toggling the Enable audit log streaming toggle.
Audit log streaming data inclusion User updated audit log streaming contents by selecting or deselecting one or more options under Include in stream in Account Settings > Audit log streaming.
Audit log streaming destination updated User updated the destination where streaming audit logs are sent in Account Settings > Audit log streaming > Audit stream destination.

# User Login Example

User login

# User Login Failed Example

User login failed


# Team Activities

Activities related to Workato teams, including collaborator invitation, role, and member modifications.

Activity Description
Invite created User invited a collaborator by going to Tools > Teams and clicking Invite collaborator. See an example.
Invite accepted User accepted the invite to join the team by clicking the Accept invite button in the invitation email. See an example.
Invite modified User modified the invitation in the Team > Pending invitations tab.
Invite canceled User canceled the invitation sent to a collaborator by clicking the Delete button in the Team > Pending invitations tab.
Member updated User updated a team member (for example, changing a role) by clicking the Edit button in the Team > Collaborators tab.
Member deleted User deleted a team member by clicking the Delete button in the Team > Collaborators tab.
Role created User added a new custom role by going to the Team > Roles tab and clicking Add new role.
Role updated User updated a custom role by going to the Team > Roles tab and clicking the Edit button of the custom role from the list of custom roles.
Role deleted User deleted a custom role by going to the Team > Roles tab and clicking the Delete button.

# Invite Created Example

Invite team member

# Invite Accepted Example

Team member joined


# Recipe Activities

Activities related to recipes.

Activity Description
Started User started a recipe by clicking the Start recipe button from the Recipe details page.
Stopped User stopped a recipe by clicking the Stop recipe button from the Recipe details page. See an example.
Created User created a new recipe by clicking the Create a new recipe button from the Recipes page.
Updated User modified a recipe by going to the Recipe details page, editing, and saving the recipe.
Renamed User renamed a recipe by clicking the recipe title, editing, and saving it.
Moved User moved a recipe from one folder to another by dragging and dropping the recipe from the Recipes page.
Cloned/Copy User cloned a recipe by clicking ... > Clone recipe in the Recipes page or clicking the Copy button in the Recipe details page.
Access scope updated User updated the access scope (public or private) of a recipe by toggling the Is this a public recipe setting found in the Recipe details > Settings tab.
Deleted User deleted a recipe by clicking ... > Delete recipe in the Recipes page or clicking the Delete button in the Recipe details page.

# Recipe Stopped Example

Recipe stopped


# Connection Activities

Activities related to connections.

Activity Description
Connection is created User created a new connection by clicking the Create a new connection button on the App connections page.
Connection is updated User updated an existing connection by going to the App connections page or the Recipe details > Connections tab, disconnecting the connection, and then modifying its settings.
Connection is connected User connected an account to or provided credentials for a connection in its Connection settings page.
Connection is disconnected User disconnected a connection by clicking the Disconnect button in its Connection settings page. See an example.
Connection is deleted User deleted a connection by going to App connections, selecting a connection, and clicking Delete connection.

# Connection Disconnected Example

Connection disconnected


# Folder Activities

Activities related to folders.

Activity Description
Folder created User created a new folder by clicking the + Create new folder in the Recipes page. See an example.
Folder deleted User deleted a folder by clicking the gear button on the folder and selecting Delete from the menu. See an example.
Folder renamed User renamed a folder by clicking the gear button on the folder and selecting Rename from the menu.
Folder moved User moved a folder by dragging and dropping it to a new destination in the Recipes page.

# Folder Created Example

Folder created

# Folder Deleted Example

Folder deleted


# Package Activities

Activities related to Recipe lifecycle management manifests and packages.

Activity Description
Manifest created User created a new manifest by going to Tools > Recipe lifecycle management and clicking Create new manifest.
Manifest updated User updated an existing manifest by going to Tools > Recipe lifecycle management > Export tab, selecting a manifest, and clicking the Edit manifest button.
Manifest deleted User deleted a manifest by going to Tools > Recipe lifecycle management > Export tab, selecting a manifest, and clicking ... > Delete manifest.
Package exported User exported a package by going to the Recipe lifecycle management page and creating, building, and packaging the manifest to a .zip file.
Package imported User imported a package by going to Tools > Recipe lifecycle management > Imports tab and clicking Import package to a new folder.

# Connector SDK Activities

Activities related to the Connector SDK.

Activity Description
Custom connector created User created a new connector by going to Tools > Connector SDK and clicking Create connector.
Custom connector updated User updated a connector by going to Tools > Connector SDK, selecting the connector, and modifying its source code.
Custom connector released User released a new version of the latest connector changes by going to Tools > Connector SDK, selecting the connector, clicking Release latest version.
Custom connector deleted User deleted a connector by going to Tools > Connector SDK, selecting the connector, and clicking Delete.

# Common Data Model Activities

Activities related to Common data models.

Activity Description
Common data model created User created a new data model by going to Tools > Common data models and clicking Create a new data model.
Common data model updated User updated a data model by going to Tools > Common data models, selecting the data model, and modifying it.
Common data model deleted User deleted a data model by going to Tools > Common data models, selecting the data model, and clicking Delete data model.

# Lookup Table Activities

Activities related to Lookup tables.

Activity Description
Lookup table created User created a new lookup table by going to Tools > Lookup table and clicking Create a new lookup table.
Lookup table updated User updated a lookup table by going to Tools > Lookup table, selecting the lookup table, and modifying it.
Lookup table deleted User deleted a lookup table by going to Tools > Lookup table, selecting the lookup table, and clicking Delete table.

# Message Template Activities

Activities related to Message templates.

Activity Description
Message template created User created a new message template by going to Tools > Message templates and clicking Create a new template.
Message template updated User updated a message template by going to Tools > Message templates, selecting the message template, and modifying it.
Message template deleted User deleted a message template by going to Tools > Message templates, selecting the message template, and clicking Delete template.

# Properties Activities

Activities related to Account properties.

Activity Description
Property created User created a new property by going to Tools > Properties and clicking Add new property.
Property updated User updated a property by going to Tools > Properties, clicking the Edit button for the property, and modifying it.
Property deleted User deleted a property by going to Tools > Properties and clicking the Delete button for the property.

# Pub/Sub Topic Activities

Activities related to Pub/Sub topics.

Activity Description
Pub/Sub topic created User created a new Pub/Sub topic by going to Tools > Pub/Sub topics and clicking Create a new topic.
Pub/Sub topic updated User updated a Pub/Sub topic by going to Tools > Pub/Sub topics, selecting the topic, and modifying it.

# API Collection Activities

Activities related to API collections.

Activity Description
API collection created User created an new API collection by going to Tools > API platform > API Collections tab and clicking Add a new API collection.
API collection updated User updated an API collection by going to Tools > API platform > API Collections tab, clicking ... > Edit collection for the collection, and modifying it.
API collection deleted User deleted an API collection by going to Tools > API platform > API Collections tab and clicking ... > Delete collection for the collection.

# API Endpoint Activities

Activities related to API endpoints.

Activity Description
API endpoint created User created a new API endpoint by going to Tools > API platform > API Collections tab, selecting an API collection from the list, and clicking Create a new endpoint.
API endpoint updated User updated an API endpoint by going to Tools > API platform > API Collections tab, selecting an API collection from the list, clicking ... > Edit endpoint for the endpoint, and modifying it.
API endpoint deleted User deleted an API endpoint by going to Tools > API platform > API Collections tab, selecting an API collection from the list, and clicking ... > Delete endpoint for the endpoint.
API endpoint activated User activated an API endpoint by going to Tools > API platform > API Collections tab, selecting an API collection from the list, selecting an API endpoint from the collection, and toggling to activate.
API endpoint deactivated User deactivated an API endpoint by going to Tools > API platform > API Collections tab, selecting an API collection from the list, selecting an API endpoint from the collection, and toggling to deactivate.

# API Customer Activities

Activities related to API customers.

Activity Description
API customer created User created a new API customer by going to Tools > API platform > Clients tab and clicking Add new client.
API customer updated User updated an API customer by going to Tools > API platform > Clients tab, clicking ... > Edit client for the customer, and modifying it.
API customer deleted User deleted an API customer by going to Tools > API platform > Clients tab and clicking ... > Delete client for the customer.

# API Access Profile Activities

Activities related to API access profiles.

Activity Description
API access profile created User created a new API access profile by going to Tools > API platform > Clients tab, selecting a client from the list, and clicking Create access profile.
API access profile updated User updated an API access profile by going to Tools > API platform > Clients tab, selecting a client from the list, clicking ... > Edit access profile for the access profile, and modifying it.
API access profile deleted User deleted an API access profile by going to Tools > API platform > Clients tab, selecting a client from the list, and clicking ... > Delete access profile for the access profile.
API access profile token refreshed User refreshed an API token associated with an API access profile by going to Tools > API platform > Clients tab, selecting a client from the list, and clicking Refresh.

# API Policy Activities

Activities related to API policies.

Activity Description
API policy created User created a new API policy by going to Tools > API platform > Policies tab and clicking Create new policy.
API policy updated User updated an API policy by going to Tools > API platform > Policies tab, selecting a policy from the list, clicking ... > Edit policy for the policy, and modifying it.
API policy deleted User deleted an API policy by going to Tools > API platform > Policies tab, selecting a client from the list, and clicking ... > Delete policy for the policy.