# Integrations Overview {#integrations-overview}


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


## Available Integrations {#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 |
| **Ever Works**   | AI agents and work   | Bi-directional |


## Integration Architecture {#integration-architecture}


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


## Entity Synchronization {#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 {#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 {#configuration}


```bash
# 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 {#related-pages}


- [GitHub Integration](https://sourcey-gauzy.pages.dev/integrations/github-integration/index.md)
- [Upwork Integration](https://sourcey-gauzy.pages.dev/integrations/upwork-integration/index.md)
- [HubStaff Integration](https://sourcey-gauzy.pages.dev/integrations/hubstaff-integration/index.md)
- [Jira Integration](https://sourcey-gauzy.pages.dev/integrations/jira-integration/index.md)
- [Activepieces Plugin](https://sourcey-gauzy.pages.dev/plugins-built-in/activepieces-plugin/index.md) — open-source automation
- [Integration Endpoints](https://sourcey-gauzy.pages.dev/api/integration-endpoints/index.md) — API reference