# Integrations

URL: /code/platform/integrations · Id: `capability:integrations`

> Integrations bind a wrapped outside Source to a System with credentials under an Agreement.

[Integrations](/business/nouns/integration) bind a wrapped outside [Source](/business/nouns/source) to a [System](/business/nouns/system) with credentials under an [Agreement](/business/nouns/agreement). The record stays in [db.sb](/code/platform/db-sb); the outside tool reflects it or feeds it.

## Contract
An Integration runs in one of two modes. In `mirror`, db.sb leads and the tool reflects it; in `import`, edits authored in the tool arrive as [Changes](/business/nouns/change). Neither mode makes the tool a second source of truth.

| Scope | Whose accounts | Example |
| --- | --- | --- |
| [Studio](/business/nouns/studio) | Shared by every [Startup](/business/nouns/startup) in a [Portfolio](/business/nouns/portfolio) | One company-lookup Source for all |
| Startup | One Startup's own accounts | The team's chat workspace |
| [Customer](/business/nouns/customer) | A Customer's accounts, used on their behalf | A Customer's calendar, connected in the [App](/business/nouns/app) |

Each [Verb](/business/nouns/verb) ranks its mappings to outside shapes, and a [Policy](/business/nouns/policy) picks one per call; the outside id is stored beside the platform id. Tokens are filled in at call time and never reach an [Agent](/business/nouns/agent). Inbound signals arrive through the webhook ingress as [Events](/business/nouns/event) and wake [Triggers](/business/nouns/trigger); a site with no API is reached through the [Browser](/code/platform/browser).

A code repository syncs with GitHub either way: db-first, where git is a projection rebuilt from db.sb, or git-first, where commits import as Changes.

## Verbs
| Verb | Object | Event |
| --- | --- | --- |
| [Integration.create](/business/nouns/integration/create) | [Integration](/business/nouns/integration) | `Integration.created` |
| [Integration.sync](/business/nouns/integration/sync) | [Integration](/business/nouns/integration) | [`Integration.synced`](/business/events/Integration.synced) |
| [Integration.call](/business/nouns/integration/call) | [Integration](/business/nouns/integration) | [`Integration.called`](/business/events/Integration.called) |

## Interfaces
- [API](/code/api/reference)
- [SDK](/code/sdk/reference)
- [CLI](/code/cli/reference)
- [MCP](/code/mcp/reference)

## Example
`hireloop.co` runs interviews for growing teams as a [Service](/business/nouns/service). Each Customer connects their own calendar inside the App, at Customer scope. Revoking it ends every Agent's access at once, and every booking made through it stays on record.