Skip to main content
C1 provides identity governance for GitBook. Integrate your GitBook organization with C1 for unified visibility and governance over user access.

​
Capabilities

ResourceSyncProvision
Users
Teams

​
Gather GitBook credentials

Use a token from a user that can see the organization’s members and teams. The token inherits the access of the user that created it, and one connector reads a single organization.
1
In GitBook, open your user account’s developer settings and create a personal access token.
2
Copy the token. GitBook shows it once at creation time.
3
Note the unique identifier of the organization you want to read. You can find it in the organization’s settings page URL in GitBook, or list the organizations your token can see with GET https://api.gitbook.com/v1/orgs.

​
Configuration fields

FieldRequiredDescription
base-urlYesThe GitBook API host, with no path and no trailing slash. For GitBook’s hosted product this is https://api.gitbook.com.
organization-idYesThe unique identifier of the GitBook organization to read. One connector reads one organization.
api-keyYesA GitBook personal access token from your user account’s developer settings.

​
Synced resource types

  • Users: organization members from /v1/orgs/{organization_id}/members, including guests and SSO-provisioned users. Disabled members sync with a disabled status.
  • Teams: organization teams from /v1/orgs/{organization_id}/teams, each with a member entitlement.
  • Team membership: team-member grants from /v1/orgs/{organization_id}/teams/{team_id}/members. Team owners and members both hold the member entitlement.

​
Special notes

  • Provisioning is not supported in the current build.
  • The connector authenticates with the personal access token as a bearer credential.
  • One connector reads the single organization named by organization-id. Spaces, sites, and collections are content surfaces and are not synced.

​
Configure the GitBook connector

Follow these instructions to use a built-in, no-code connector hosted by C1.
1
In C1, navigate to Integrations > Connectors and click Add connector.
2
Search for GitBook and click Add.
3
Choose how to set up the new GitBook connector.
4
Set the owner for this connector.
5
Click Next.
6
Find the Settings area of the page and click Edit.
7
Enter the GitBook credentials:
  • GitBook API host: The API host, usually https://api.gitbook.com.
  • Organization ID: The unique identifier of the organization to read.
  • API token: The personal access token.
8
Click Save.
9
The connector’s label changes to Syncing, followed by Connected. You can view the logs to ensure that information is syncing.
Done. Your GitBook connector is now pulling access data into C1.