Skip to main content

Get started


To use the IS Deployments API, you need to authenticate with Guidewire Hub and obtain an access token.

For all the planet classes, to perform any operations, you must have an access token with tenant.{tenantId} and project.{projectId} scopes.

Get an access token

To get a user access token, you must be in the {tenant}.dev.{project}.all.gcc.developers user group.

Send the following request containing your client ID and client secret:

curl -s --location --request POST $GWHUB_URL \
--data-urlencode "grant_type=client_credentials" \
--data-urlencode " gcc.projects.write
tenant.{tenantId} project.{projectId}" \
--data-urlencode "client_id=$GWHUB_CLIENT_ID" \
--data-urlencode "client_secret=$GWHUB_CLIENT_SECRET" | jq -r '.access_token'

Depending on your region, replace GWHUB_URL with one of the following URLs:


The response contains a JSON object with the requested access token:

"token_type": "Bearer",
"expires_in": 3600,
"access_token": "xxxxxxxx",
"scope": " gcc.projects.write
tenant.{tenantId} project.{projectId}"

Make an authenticated call

Add the following header with the obtained access token to all your requests:

Authorization: Bearer {access_token}

For example:

curl -s --location --request GET "$GCC_API_URL" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $ACCESS_TOKEN"

Base URLs

Depending on your region, use one of the following base URLs:

RegionBase URL

When the documentation refers to {baseUrl}, replace it with the correct URL for your region.