Browse documentation

Audit log

Developer > Integrations > Audit Log. The audit log is the record of what happens in the Entity you are in. Entries are immutable: nobody can edit or delete them from the app.

How the log works

Every entry answers three questions:

  1. Who: the actor, such as a person, an API key or the system.
  2. What: the action and the record it touched, such as an invoice, a transaction or a notification rule.
  3. From where: the source, such as the app, the API, an automation or an import.

Entries also keep the date and time, and, when something changed, the values before and after.

The Audit Log page: filters for Entity ID, invoice code, transaction code, entity, action, actor type, actor, source and dates with Export and Reset buttons, and a table of entries such as Api Key Revoked, Notification Rule Test Sent, Notification Rule Updated, Transaction Ignored and Api Key Created, each with a record type, an actor with the email blurred, and a source

Each line of the table is one entry. It shows the timestamp, a colored badge with the action, the type of record with a short ID or its code, the actor, the source, and an eye icon that opens the entry. The newest entries come first.

Find an entry

Use the filters at the top of the page. They can be combined.

FilterWhat it does
Entity IDA record’s full ID, when you have it.
Invoice code and Transaction codeEntries about one invoice or one transaction, for example INV-2024-001.
EntityThe type of record, such as api_key, notification_rule or transaction.
ActionWhat was done, such as Api Key Revoked or Transaction Ignored.
Actor type and ActorWho did it: a type first, then a name.
SourceWhere it came from.
From and ToA range of dates.

Reset clears all the filters. The table is paged.

Actors and sources

Actor typeMeaning
UserA member working in the app.
API keyA system calling the API, shown by the key’s name. See API keys.
SystemInvunion itself, for example when it suggests a match.
SupportInvunion support working on your request.

Entries written before actors were tracked say so.

SourceMeaning
AppSomeone used the screens.
APIA call to the API.
AutomationA rule or a background job.
ImportA file or an API import.

Open an entry

Select the eye icon on a line. The Audit entry panel opens, with the entry number, the action, the type of record and the source at the top.

The Audit entry panel for an Api Key Revoked entry: tabs Overview and History, a Who section with actor, timestamp, actor ID, IP address, request ID and user agent, a What section with the entity and its ID, a Changes section saying no before and after data was recorded, a Raw JSON line, and the Filter by this entity and Close buttons. The identifiers are blurred

The Overview tab has four parts:

  • Who: the actor, the timestamp and, when it was recorded, the actor ID, the IP address, the request ID and the user agent. If the actor is an API key, a link takes you to the keys.
  • What: the type of record and its ID. For a match, Related documents lists the codes of the transaction and the invoice.
  • Changes: each field with its value before and after. Some entries have no changes to show, as in the screenshot, and the panel says so.
  • Raw JSON: the full entry as recorded, with a copy button.

The History tab lists every recorded change for the same record, oldest first, and its number tells you how many there are. Filter by this entity closes the panel and filters the table on that record.

Example: a suggested match

Invunion found a possible match between a transaction and an invoice and suggested it, so the entry has the actor System and the source Automation. A suggested match waits in the Match inbox until a person confirms or rejects it. See Match levels.

The Audit entry panel for a Transaction Match Suggested entry: actor System, a What section with the transaction and its related documents, the transaction TRX-435A797C and the invoice FAC-2026-018, and a Changes table where the matches field goes from an empty list to a new match with the status pending_review
PartWhat it tells you
Related documentsThe transaction and the invoice that were compared, with their codes.
ChangesThe matches field was empty before. After, it holds a new match with the status pending_review, which means it waits in the Match inbox for a person.

Export

Export offers Export as CSV and Export as JSON. The file contains what the current filters show, up to 100,000 rows. Narrow the dates first if you have more.

How long it is kept

Recent entries stay in the app for 12 months. Older ones are archived and no longer appear on the screen.

Limits to keep in mind

  • The log shows what Invunion recorded. It does not replace the audit trail of your accounting system.
  • Entries contain names, codes and amounts. Share exports only through approved channels.

Updated · View as Markdown