Integrations
Google Calendar Sync
Two-way sync between Person Trail jobs and your Google Calendar.
Google Calendar sync keeps your scheduled jobs and phases visible on your personal calendar. It is available on all plans at no extra cost.
How It Works
- Per-user connection: Each team member connects their own Google Calendar. Your calendar is not shared with other team members.
- Automatic push: When a job or phase is created, updated, or deleted in Person Trail, the corresponding calendar event is automatically updated.
- Manual pull: Click "Sync from Calendar" to pull time changes you made directly in Google Calendar back into Person Trail.
What Gets Synced
| Person Trail Entity | Calendar Event |
|---|---|
| Job | Event with job type as title, property address as location, scheduled start/end as time, client and contractor info in description |
| Phase (with schedule) | Separate event titled "Job Type -- Phase Name" with the phase schedule |
Connecting
- Go to Settings > Integrations
- Click the Google Calendar card
- Click Connect Google Calendar
- Sign in with your Google account and grant access to calendar events
- You will be redirected back to Person Trail with a "Connected" status
Person Trail requests only the calendar.events scope, which allows reading and writing calendar events. We do not access your contacts, emails, or other Google data.
Sync Settings
After connecting, you can toggle:
- Sync jobs -- Push jobs as calendar events (on by default)
- Sync phases -- Push phases with scheduled times as separate events (on by default)
Changes take effect immediately for future syncs.
Sync Actions
- Push to Calendar -- Syncs all your jobs and phases to Google Calendar right now
- Sync from Calendar -- Pulls time changes from Google Calendar back into Person Trail (useful if you rescheduled events directly in Google Calendar)
Role-Based Filtering
- Owner, Admin, Coordinator: All organization jobs are synced to your calendar
- Crew Member: Only jobs assigned to you are synced
Disconnecting
- Go to Settings > Integrations > Google Calendar
- Click Disconnect
- Confirm in the dialog
Disconnecting stops all future syncing. Events already created in Google Calendar are not deleted. Your OAuth tokens are revoked and removed from our system.
Troubleshooting
- Events not appearing? Make sure "Sync jobs" is toggled on and click "Push to Calendar" to force a full sync.
- Time changes not reflected? Click "Sync from Calendar" to pull updates from Google Calendar.
- Error status? Check the error message on the detail page. Common issues include expired tokens (reconnect to fix) or Google API rate limits (wait and retry).