For AI agents: a documentation index is available at /llms.txt. A markdown version of this page is available at /guide/cloud/integrations/overview.md.

CloudIntegrations

Integrations

Connect Orangescrum to the tools your team already uses — Git, Azure DevOps, Google Workspace and more.

Pro and Premium

Git sync and Google Workspace integrations require Pro Unlimited or above. SSO is Premium. See the feature matrix.

#What's available

#Choosing what to connect

Every integration is a thing that can break, produce noise, or drift out of sync. Connect the ones that remove real manual work.

  1. Start with where you lose time

    If people copy ticket numbers into commit messages by hand, Git sync pays for itself immediately. If nobody does that, it will not.

  2. One at a time

    Connect it, use it for a fortnight, then decide whether to add another. Turning on five at once means you cannot tell which one is causing the noise.

  3. Set it up per project

    Most integrations are configured per project, so each links to the right repository or calendar.

  4. Check what it generates

    An integration that posts a notification for every commit will be muted within a week — including the notifications that mattered.

#Two-way sync needs care

Two-way sync means two sources of truth

When the same item exists in two systems and both can edit it, they will eventually disagree. Decide which system owns which field before turning it on — for example, Orangescrum owns priority and assignee, the other tool owns status.

This applies most to Azure DevOps. Git sync is largely one-way and much safer.

#Permissions

Integrations authenticate as a user or an app, and inherit those permissions.

  1. Use a service account where you can

    An integration wired to a person's account breaks when that person leaves.

  2. Grant the narrowest scope that works

    Read-only if the integration only reads.

  3. Review connections periodically

    Disconnect what nobody uses. Every live connection is exposure.

#When something stops syncing

Check the credential first

Expired tokens and revoked access are the most common cause by a wide margin, and they fail quietly.

Then check the mapping

A status or field renamed on either side breaks the mapping. Renaming statuses is a frequent trigger.

Then check permissions

Someone's access changed, or a repository moved.

Then reconnect

Re-authorising fixes a surprising proportion of problems.

#Building your own Premium

If nothing off the shelf fits, the Developer API covers projects, tasks, timelogs, users, test cases, defects and checklists.

Developer API

59 endpoints, HMAC-signed, with an OpenAPI spec.