Integrated Data

GitHub

What this page covers: A complete reference mapping every GitHub data type to its Mosaic equivalent. Use this guide when configuring your integration, verifying synced data, or troubleshooting discrepancies.

Integration typeCloud (GitHub REST API / Webhooks)
Setup complexityLow
PrerequisiteGitHub Integration Setup

How Data Flows

GitHub (REST API / Webhooks) → Mosaic Sync Engine (field mapping) → Mosaic (3 synced data types)


Integrated Data Types

The integration syncs 3 data categories from GitHub into Mosaic:

#Data TypeDescription
1EmployeesUser accounts mapped to Mosaic employees
2ProjectsRepositories, Organization Projects, Repository Projects, and Project Cards mapped to Mosaic projects and milestones
3TasksIssues mapped to Mosaic tasks

This list may expand as new features are added. If new features require additional permissions, your Customer Success Manager will reach out to request that they be added to the role you have assigned to the Mosaic user.


Detailed Field Mappings

Jump to a section: Employees | Projects (Repositories) | Projects (Organization Projects) | Projects (Repository Projects) | Milestones | Projects (Project Cards) | Tasks (Issues)


Employees

What Syncs to MosaicWhere It Comes From in GitHub
Employee NameUser Name
Employee EmailUser Email
Employee UsernameUser Username

Projects (Repositories)

What Syncs to MosaicWhere It Comes From in GitHub
Project TitleRepository Name
Project SchedulesRepository Status (disabled / archived / open)

Projects (Organization Projects)

What Syncs to MosaicWhere It Comes From in GitHub
Project TitleOrganization Project Name
Project SchedulesOrganization Project State

Projects (Repository Projects)

What Syncs to MosaicWhere It Comes From in GitHub
Project TitleRepository Project Name
Project SchedulesRepository Project State

Milestones

What Syncs to MosaicWhere It Comes From in GitHub
Milestone DescriptionMilestone Title
Milestone End DateMilestone Due Date
Milestone StateMilestone State

Projects (Project Cards)

What Syncs to MosaicWhere It Comes From in GitHub
Project TitleProject Card Title
Project SchedulesProject Card Creator
Project StatusProject Card Completion Status

Tasks (Issues)

What Syncs to MosaicWhere It Comes From in GitHub
Task DescriptionIssue Name
Task CreatorIssue Creator
Task AssigneeIssue Assignee
Task StatusIssue Completion Status

GitHub Documentation Links

A consolidated reference of all GitHub documentation referenced in this guide:

TopicLink
REST API OverviewGitHub REST API
UsersUsers API
RepositoriesRepositories API
ProjectsProjects API
IssuesIssues API
MilestonesMilestones API

Related Documentation

Unsupported Data Sources: Integrating data types that are not explicitly listed in this documentation is not supported. If there is a data endpoint not listed here and it is required for your integration, it will be a customization, charged at an hourly rate.