View Integration Logs
How to view, filter, and export integration sync logs to monitor data flow and diagnose issues.
What this guide covers
This guide shows you how to access and use integration logs to monitor data sync activity. You will learn how to filter logs, read log entries, and export logs for support or auditing purposes.
Step 1: Open integration logs
- Go to
/settings> Integrations. - Click the integration you want to inspect.
- Click the Sync Log tab.
Screenshot: The sync log tab showing a filterable table with columns for timestamp, entity, direction, status, and details.
Step 2: Filter logs
Use the filter controls above the table:
- Status -- show only errors, warnings, or successes.
- Entity -- filter by contact, invoice, item, or payment.
- Direction -- show only pushes or only pulls.
- Date Range -- narrow to a specific time period.
Step 3: Read log entries
Each log entry contains:
- Timestamp -- the exact time of the sync attempt.
- Entity Type -- what kind of record was synced.
- Record Name -- the specific record (e.g., customer name).
- Direction -- push (outbound) or pull (inbound).
- Status -- synced, matched, skipped, warning, or error.
- Details -- a plain-language explanation.
Animation: Clicking a log entry row to expand it and see additional details including the record ID, field changes, and error stack trace.
Step 4: Export logs
Click Export Log to download the filtered log entries as a CSV file. This is useful for:
- Sharing with support when troubleshooting.
- Audit records for compliance purposes.
- Analyzing sync patterns over time.
Tip: Check your sync logs weekly. A quick scan of the error count tells you if the integration is healthy or needs attention.
Note: Log entries are retained for 90 days. Export logs you need to keep longer before they expire.
Related articles
Did this answer your question?