Integration overview
What Are Integrations?
Integrations connect external services to SubImage using OAuth-based authentication. Once installed, an integration provides SubImage with the credentials needed to interact with the service on your behalf — no manual token management required.
Integrations are managed from Settings > Integrations.
Integrations vs Sync Modules
An integration connects SubImage to an external service via OAuth. You only need to install it once — after that, any feature that depends on the connection (sync, notifications, ticketing, etc.) can be enabled or disabled from the corresponding module without additional configuration.
A sync module controls what data is pulled from a connected service and how often. Some modules require an integration to be installed first (e.g. GitHub, Slack); others work with their own credentials (e.g. AWS, GCP, Okta).
When Do I Need a Sync Module Without an Integration?
- The service does not have an integration (e.g. AWS, GCP, Okta)
- You are connecting a self-hosted instance that the OAuth flow cannot reach (e.g. GitHub Enterprise Server, self-managed GitLab)
- You need fine-grained control over credentials (e.g. per-org PATs)
Setup Guides
Use these guides for app-specific permissions, scopes, and configuration details: