Logs & Audit Overview

The Logs & Audit section is your window into what's happening behind the scenes in your account. It covers three kinds of activity:

System Logs: errors the platform ran into, like a failed integration sync or a webhook that couldn't be delivered.
Audit Logs: every configuration change made by someone on your team, with a before and after view of what changed.
Login Logs: every login attempt to your account, successful or not.

Before this page existed, answering questions like "why did our Shopify sync stop working?" or "who changed this campaign?" meant reaching out to support. Now you can look it up yourself in a few clicks.

You'll find the Logs page in the left sidebar under Admin & Configuration → Logs & Audit. The page opens on the System tab, with Audit and Login tabs right beside it.

System Logs

System Logs capture operational events generated by the platform itself: API errors, integration sync failures, webhook delivery problems, and payment processing issues. These aren't things your team did wrong. They're platform-level problems worth knowing about.

Severity levels

Level	What it means
Critical	A major failure that needs attention right away, like the payment system being unavailable.
Error	Something failed and should be looked into, like a webhook that couldn't be delivered or an integration sync that didn't finish.
Warning	Something unusual that hasn't caused a failure yet, but may need a look.
Info	Normal operational events, logged for reference.

How to review your system logs

Go to Admin & Configuration → Logs & Audit. The System tab opens by default.
Use the level filter at the top of the page to show only Critical, Error, Warning, or Info entries.
Use the source filter to narrow things down to a specific integration or platform component, such as Shopify, webhooks, or payments.
Use the date range picker to focus on a specific window of time.
Use the search bar to search across error codes, messages, sources, and request IDs.
Check the statistics cards at the top for a quick count of entries by severity level in the range you selected.
Click Export CSV to download the filtered results if you want to dig in offline or share them with your team.

What system logs don't include

System Logs only capture server-side platform errors. If a request from your side is malformed, for example a bad API call, it won't show up here. The entries you're most likely to see are integration sync failures and webhook delivery problems.

Audit Logs

Audit Logs record every configuration change made in your account, so you always have an answer to "who changed this, and when?" Each entry shows the person who made the change, the timestamp, and a field-by-field comparison of what the value was before and after.

Changes are tracked whether they were made in the Ambassador admin or through the API. API changes are attributed to the API user's identity.

What gets tracked

Programs and Campaigns (setup, name changes, status, settings)
Rewards (rule creation and changes)
Segments (creation and membership changes)
Payment settings for a campaign
Pages (creation, content, and URL changes)
Branding and display settings
Automations (creation, step changes, activating and deactivating)
More added as we release new features

Action types

Action	What it means
Create	Something new was created, like a campaign or a reward rule.
Update	Something existing was modified. The change detail shows the old value and the new value for every field that changed.
Delete	Something was removed.

How to review your audit logs

Go to Admin & Configuration → Logs & Audit and open the Audit tab.
Use the date range picker to select the period you want to look at.
Use the search bar to search by user email, entity type, or action.
Scan the rows. Each one shows the timestamp, the action type as a color-coded chip, the entity type and ID, and who made the change.
Click the changes link on any row to open the full before and after comparison. Old values appear in red, new values in green.
Check the statistics cards for total Create, Update, and Delete counts in the period you selected.
Click Export CSV if you need the records for a compliance review or internal audit.

If a campaign or setting behaves differently than you expect, this is the fastest place to look. Filter to the date things changed, search for the campaign, and the changes modal will show you exactly which fields moved.

Login Logs

Login Logs record every login attempt to your account, whether it succeeded or failed. This is useful for security reviews and for spotting repeated failed attempts.

Go to Admin & Configuration → Logs & Audit and open the Login tab.
Use the date range picker to select the period you want to review.
Use the search bar to search by email, IP address, authentication source, or status.
Review the rows. Each one shows the timestamp, the authentication source (SSO, direct login, API, or storefront), the success or failure status, the user email, and the IP address.
Check the statistics cards for a success versus failure count.
Click Export CSV to save the results for a security review.

Who can access the Logs page

The Logs page is available to users with an Admin or IT role, and it covers all three tabs. If someone on your team can't see the page at all, check their role first.

A few things worth knowing

Keep an eye on integrations. If you have active integrations like Shopify or HubSpot, it's worth checking the System tab weekly so recurring sync errors don't go unnoticed.
Failed webhooks show up here too. If a webhook you've configured keeps failing to deliver, those failures are recorded in the System Logs.
Every tab exports. All three tabs support CSV export, and the export respects whatever filters you have applied.

Want alerts instead of checking manually?

You don't have to visit this page to stay informed. You can set up notifications that deliver system error digests by email, webhook, or Slack, and there's a real-time notification bell in the top navigation. See Setting Up Notifications and Alerts for how to get that configured.

Logs & Audit Overview

Monitor System Errors, Configuration Changes, and Login Activity in Your Account.