Audit log
A record of who changed what in your organisation and when, with a filtered export for System Activity.
A record of who changed what in your organisation and when, with a filtered export for System Activity.
The Audit Log is at Settings > Audit Log. It has three tabs: System Activity, Email Activity and SMS Activity. This article covers System Activity, the tab that answers who changed something and when. The other two tabs show the emails and texts Recruit has sent and are covered in a separate article.
Who can open it
Only users with the Admin role. HR, Member and Agency users do not see Audit Log in Settings, and if they open the page address directly they get the message "Only admins can view the audit log." All three tabs and the export are Admin only.
If your organisation is part of a group, a company selector appears at the top right of the page. The System Activity tab shows the activity of the company you select.
System Activity
Each row is one recorded action. Newest entries come first.
- Timestamp: when it happened. Click the heading to switch between newest first and oldest first.
- User: the person who did it. If Recruit has no name for them, their user ID is shown instead. Actions Recruit carries out automatically, such as the nightly data retention run, have no user.
- Action: what was done, written as the area followed by the action, for example jobs.update or users.deactivate.
- Entity Type and Entity ID: the kind of record affected and its reference.
- Changes: a View Changes button appears when values were recorded. Otherwise the cell reads "No changes recorded".
Reading a change
- Select View Changes on a row.
- A panel titled Change Details opens on the right, with a Before section and an After section.
- Compare the two. A section reads "No changes recorded" when there were no values on that side, which is normal for a newly created record (nothing before) or a deletion (nothing after).
Filters
Filters apply on their own a moment after you change them. There is no Apply button. Every change to a filter returns you to page 1.
- Entity Type: Candidates, Jobs, Applications, Users, Pipeline Stages, Custom Reports, Interview Assignment, Interview Video Review, Interview Event, Interview Event Slot, Interview Booking or Interview Invitation. Rows for other kinds of record, such as offers or onboarding, appear when this is left on All entity types but cannot be picked here.
- Action: create, update, delete or auth.login. The filter matches part of the action text, so update also finds actions such as users.update_role.
- User ID: the exact ID of one user, up to 36 characters. Copy it from the User column of a row where an ID is shown.
- Start Date and End Date: pick a date in each. The start date includes everything from the beginning of that day. The end date is read as the very start of that day, so entries made during the end date itself are left out. To include a whole day, set the end date to the following day.
Select Reset Filters to clear them all. The footer shows which rows you are looking at and the total. Change Rows per page to 20, 50 or 100, and use Previous and Next to move between pages.
To find who changed a user's role, set Entity Type to Users and Action to update, then open View Changes on the matching row to see the role before and after.
Exporting System Activity
- Set the filters for the entries you want.
- Select Export above the table.
- Choose Export as CSV or Export as Excel.
The file is named audit-log followed by today's date. It contains the columns Timestamp, User, Action, Entity Type, Entity ID, Before and After, and only the rows that match your filters. The sort order on screen does not change the file. A message confirms "Audit log exported successfully", or "Failed to export audit log. Please try again." if it did not work.
An export holds at most the 10,000 most recent matching entries. If there are more, the CSV ends with a note saying how many were included, and the Excel file gets a Summary sheet showing the total matching and the number exported. Narrow the dates and export again to get the rest. Values in fields that look like passwords, tokens, bank details, national insurance numbers or dates of birth appear as *** in the file. The Email Activity and SMS Activity tabs have no export.
What is recorded and what is not
System Activity holds successful changes and a set of specific events. Broadly, that covers:
- Candidates: creating and editing, merging duplicates, marking a candidate as not a duplicate, notes, right to work updates, document requests, and revealing a redacted candidate.
- Applications: moving between stages, rejecting, withdrawing, reactivating, edits to form answers, and form and cover letter PDF downloads. A Hiring Manager opening the gap analysis on an anonymised application is also recorded.
- Jobs: creating, updating, duplicating, deleting, approving and rejecting, and changes to the hiring team.
- Offers: creating, sending, superseding, withdrawing and deleting.
- Users: invitations, role changes, deactivating and reactivating, password reset emails, and MFA or session resets by an Admin.
- Sign-ins, password changes and MFA changes.
- Custom flags: creating a flag, and changing whether it is marked Visible to Admin and HR only. Changes to the UK inclusion schemes switches are recorded as well.
- Interviews and scheduling, shortlisting checklists and scores, onboarding, and document uploads, downloads and deletions.
- Data protection: deletion requests, retention policies and consent records.
- Single sign on setup, calendar connections, and email addresses reinstated after a bounce.
Some things never appear:
- Looking at a page or record. Only the downloads and the gap analysis view above are logged as views.
- Failed requests. If a save is rejected, no entry is made.
- Failed sign in attempts. Only successful sign ins are logged.
- The content of emails and texts. Those appear on their own tabs, not in System Activity.
- Anything older than your retention period.
How long entries are kept
Recruit deletes audit entries older than 365 days. The clean up runs every day. To keep entries for a different length of time, an Admin or HR user adds a retention policy with Applies To set to Audit Logs. The period can be from 1 to 3650 days. The steps are in Setting up retention policies and warnings.
Shortening the period removes older entries on the next daily run, and this cannot be undone. Export anything you need first.