Hosts and authorization

See the supported regions and required scopes of commercetools Connect.

Hosts

The Connect API has different hosts from Composable Commerce HTTP API hosts. You can access the Connect API at the following URLs:

RegionAPI URL
Europe (Google Cloud, Belgium)https://connect.europe-west1.gcp.commercetools.com/
North America (Google Cloud, Iowa)https://connect.us-central1.gcp.commercetools.com/
Australia (Google Cloud, Sydney)https://connect.australia-southeast1.gcp.commercetools.com/
North America (Azure, Virginia)https://connect.eastus.azure.commercetools.com/

If documentation refers to https://connect.{region}.commercetools.com, you should use the respective API URL of the Region that hosts your Composable Commerce Project.

The Connect API is only available in Google Cloud and Azure Regions.

Authorization

The Connect API uses tokens from Composable Commerce HTTP API authorization flows with the following scopes:

  • manage_project:{projectKey}: grants permission to use all Connect API endpoints in a Project. To access individual API endpoints, use more selective permissions.
  • view_connectors:{projectKey}: grants permission to view Connectors in a Project.
  • manage_connectors:{projectKey}: grants permission to view, create, update, and delete Connectors in a Project.
  • view_connectors_deployments:{projectKey}: grants permission to view Deployments in a Project.
  • manage_connectors_deployments:{projectKey}: grants permission to view, create, update, and delete Deployments in a Project.