---
schema_version: "1"
id: 018050b07e01c32888ffecf086dd7747a214e09776073f62c01ded8600b4a339
title: GitHub Synchronization
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/design-center/design-ghs-about-github-sync.md
canonical_url: https://docs.mulesoft.com/design-center/design-ghs-about-github-sync
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 7ebf470584e9afad0740f4ad782d9547d76460ee82899638cc109f0ecb5f3a4e
description: MuleSoft Documentation Site
latest: true
---
---
product: Design Center
---

# GitHub Synchronization

> For the full documentation index, see: https://docs.mulesoft.com/llms.txt

API specification designers often use multiple authoring and version control tools. This can result
in maintaining several different specification versions.

GitHub Synchronization is a version control tool that maintains API specifications existing in
several locations. Use GitHub Synchronization to enable two-way synchronization between API Designer
and your GitHub repository and to automatically capture changes to API projects and send the changes
to a synchronized GitHub repository of your choice. Similarly, the application automatically
propagates to your API project any changes made in a synchronized GitHub repository.

This bidirectional flow extends API Designer into a collaborative environment where the single
source of truth is always GitHub. Unlimited collaborators can share and contribute to the same
content.

Using GitHub synchronization with API Designer enables you to:

- Create new GitHub repositories that synchronize with existing API projects.

- Create new API projects that synchronize with new GitHub repositories.

- Create new API projects that synchronize with existing remote GitHub repositories.

To perform GitHub-specific actions, such as opening pull requests, viewing branch diffs, or viewing
synchronization status, use the GitHub UI.

## See Also

- [Install and Authorize GitHub Synchronization](https://docs.mulesoft.com/design-center/design-ghs-install-authorize)

- [Create a New Project Synchronized with a New GitHub Repository](https://docs.mulesoft.com/design-center/design-ghs-new-project-new-repo)

- [Create a New Project Synchronized From an Existing GitHub Repository](https://docs.mulesoft.com/design-center/design-ghs-new-project-existing-repo)

- [Create a New GitHub Repository Synchronized from an Existing Project](https://docs.mulesoft.com/design-center/design-ghs-new-repo-existing-project)