Integrations
Bidirectional collaboration layer for Notion and GitHub. Credentials/webhook secrets are represented as server-side secret references; staging queues and inspects sync work without exposing tokens in the UI.
GitHub
Sync Workflow Hub issues with GitHub Issues/PRs: title, body, labels, assignee, state/status, comments, and backlinks.
Notion
Sync issues with Notion database pages: title, rich description, status/selects, priority, owner, due date, and backlinks.
Conflict policy
Choose newest-wins, local-wins, external-wins, or manual-review. Conflicts are recorded as sync events before overwrites.
Add/update connection
Connections
| Provider | Name | Enabled | Direction | Conflict policy | Last sync |
|---|---|---|---|---|---|
| No integration connections configured yet. | |||||
Manual sync
This creates outbound sync events for linked issues. Actual API push/pull can be enabled once tokens/webhooks are configured.
Recent external links
| Provider | Issue | External ID | State | Last synced |
|---|---|---|---|---|
| No issue links yet. | ||||
Sync event queue
| Created | Provider | Direction | Status | Message |
|---|---|---|---|---|
| No sync events yet. | ||||
Bidirectional sync design checklist
- Canonical local issue fields: summary, description, status, priority, type, labels, due date, assignee, comments.
- External links store provider IDs, URLs, checksums, timestamps, and sync state.
- Inbound webhooks create SyncEvents and can update local issues after conflict checks.
- Outbound edits queue SyncEvents for each linked GitHub/Notion item.
- Conflict handling compares local checksum/timestamps against external updated time.