Integrations Overview

Ever Gauzy integrates with popular third-party services for project management, time tracking, hiring, and communication.

Available Integrations

Integration	Category	Sync Direction
GitHub	Project Management	Bi-directional
Upwork	Freelance Management	Import
HubStaff	Time Tracking	Import
Jira	Project Management	Bi-directional
Wakatime	Activity Tracking	Import
Activepieces	Automation	Bi-directional

Integration Architecture

External Service
     │
     ├── Webhooks ──→ Integration Handler ──→ Create/Update Entities
     │
     └── API Polling ──→ Sync Service ──→ Create/Update Entities

Entity Synchronization

Integrations map external entities to Gauzy entities:

External	Gauzy Entity	Mapping
GitHub Issue	Task	title, description, status
GitHub PR	Task (linked)	PR reference
Upwork Contract	Employee	billing, hours
HubStaff Activity	TimeLog	duration, screenshots
Jira Issue	Task	title, priority, status

Integration Settings

Each integration stores:

Field	Description
name	Integration name
entitySettings	Which entities to sync
settingsMap	Configuration key-value pairs
lastSyncedAt	Last sync timestamp
isActive	Active/disabled status

Configuration

# GitHub
GAUZY_GITHUB_APP_ID=your-github-app-id
GAUZY_GITHUB_APP_NAME=your-github-app-name
GAUZY_GITHUB_APP_PRIVATE_KEY=base64-encoded-key
GAUZY_GITHUB_WEBHOOK_SECRET=webhook-secret
GAUZY_GITHUB_CALLBACK_URL=https://api.yourdomain.com/api/integration/github/callback

# Upwork
UPWORK_API_KEY=your-upwork-key
UPWORK_API_SECRET=your-upwork-secret
UPWORK_REDIRECT_URL=https://api.yourdomain.com/api/integration/upwork/callback

# HubStaff
HUBSTAFF_CLIENT_ID=your-hubstaff-id
HUBSTAFF_CLIENT_SECRET=your-hubstaff-secret
HUBSTAFF_REDIRECT_URL=https://api.yourdomain.com/api/integration/hubstaff/callback

# Jira
JIRA_URL=https://your-domain.atlassian.net
JIRA_API_TOKEN=your-jira-api-token
JIRA_USER_EMAIL=your-jira-email

# Activepieces
ACTIVEPIECES_BASE_URL=https://cloud.activepieces.com
GAUZY_ACTIVEPIECES_API_URL=https://api.activepieces.com/v1
GAUZY_ACTIVEPIECES_API_KEY=your-activepieces-api-key

Related Pages

• GitHub Integration
• Upwork Integration
• HubStaff Integration
• Jira Integration
• Activepieces Plugin — open-source automation
• Integration Endpoints — API reference