Configure Email Sync

Set up automatic invoice import from an email mailbox. When email sync is configured, TT Time Tracker polls the mailbox regularly and imports any invoice attachments it finds.

:::note The email sync feature must be enabled in your workspace settings. Go to Admin → Settings and toggle Email Sync on. :::

Prerequisites

• An email address dedicated to receiving invoices (e.g. invoices@yourcompany.com)
• IMAP access enabled on that mailbox
• IMAP credentials (server, port, username, password)

Step 1 — Navigate to syncs

1. Go to Admin → Syncs
2. Click Add sync or Configure

Step 2 — Enter IMAP credentials

Fill in the connection details for your mailbox:

Field	Description
Email	The email address of the mailbox
IMAP host	Your mail server's IMAP hostname (e.g. imap.gmail.com)
IMAP port	Usually 993 (SSL) or 143 (STARTTLS)
Username	Usually the same as the email address
Password	IMAP password or app-specific password

For Gmail, use an App Password rather than your main Google password.

Step 3 — Test the connection

Click Test connection to verify TT Time Tracker can connect to the mailbox. A success message confirms the credentials are correct.

Step 4 — Save

Click Save. TT Time Tracker will begin polling the mailbox on the next sync interval.

Monitoring sync status

The Syncs page shows:

• Last synced at — when the most recent sync ran
• Status — active, error, or disabled
• Imported — count of invoices imported from this mailbox

If status shows error, check the IMAP credentials and ensure the mail server is accessible.

Removing a sync

1. Open the sync configuration
2. Click Delete

Invoices already imported from that mailbox are not deleted.