Deel Integration

Overview

Integration with Deel to sync time tracking data with contractor timesheets.

Deel API

Deel provides a REST API for developers to build integrations.

Relevant API Resources

ResourceDescription
TimesheetsSubmit and manage contractor timesheets
ContractsAccess contract information
TasksManage tasks within contracts
MilestonesTrack project milestones

Authentication

Two authentication methods available:

  1. API Token (recommended for personal use)

    • Generate in Deel Developer Center
    • Personal tokens inherit user permissions
    • Organization tokens for broader access

  2. OAuth 2.0 (for multi-user apps)

    • Standard OAuth flow
    • Required for distribution

Sandbox Environment

Deel provides a sandbox for testing:

  • Create sandbox account from Developer Center
  • Test with sample data
  • No effect on production

Integration Scope

Phase 1: Export to Deel

  • Export time records as timesheet entries
  • Map tags to Deel contracts/tasks
  • Manual sync trigger

Phase 2: Two-way Sync (Future)

  • Import contracts from Deel
  • Auto-create tags from contracts
  • Sync timesheet status back

Data Mapping

TimeTrackerDeel
TimeRecordTimesheet entry
TagContract/Task
startTimeStart datetime
endTimeEnd datetime
durationHours worked
commentDescription

Configuration

Settings required:

  • Deel API token
  • Contract mapping (tag -> Deel contract ID)
  • Default contract (for untagged records)

Implementation Notes

  • Store API token securely in Keychain
  • Respect Deel API rate limits
  • Handle network errors gracefully
  • Queue failed submissions for retry

Related