How integrations work
Understand how Doow validates, syncs, pauses, and disconnects sources.
An integration is a connection between Doow and a source your company already uses. It exists so Doow can read, receive, or collect data for usage, people, and spend reviews.
Each source uses the connection method that matches where the data lives. The path is usually the same: connect or enable the source, confirm data arrived, and monitor the connection over time.
Connection methods
| Method | Used for | What you provide |
|---|---|---|
| OAuth | Google Workspace, Microsoft 365, Zoho | Admin consent through the provider |
| Client credentials | Okta, OneLogin | Domain, client ID, and client secret |
| API key or token | OpenAI, Anthropic, Datadog, New Relic, Sentry | Read-only credential from the provider |
| Service credential | AWS, Azure, Google Cloud | Read-only IAM, service principal, or service account credential |
| Secure linking flow | HRIS and accounting providers | Provider authorization through a secure modal |
| Installed agent | Doow Agent | Approved Browser Agent or Desktop Agent rollout path |
| SDK or OTLP push | Custom usage events and OpenTelemetry metrics | dk_ API key from Doow |
What happens after you connect
After you select Connect, install an agent, or enable a push source, Doow validates the source in the way that matches that connection. Credentials and authorization grants are verified. Agents are confirmed by sign-in, tracking state, and recent activity. Push sources are confirmed by received events or metrics.
If validation succeeds, the integration appears in My connections and Doow starts receiving or syncing data. The first sync or first activity window can take longer than later updates because Doow needs to fetch, receive, normalize, and match records for the first time.
If no records appear after the first connection, check the sync status, agent activity, tracking state, or event log before adding another source to work around the issue.
Confirm a connection worked
A healthy connection shows:
- A connected state in Company Settings, then Integrations.
- A recent sync, event, or activity timestamp.
- Imported records in the integration detail page.
- No credential or permission errors in the event log.
The integration card appears in My connections and shows that the source is connected.
The detail page shows a recent sync, event, or received-metric timestamp.
The detail page contains users, employees, expenses, usage rows, or events from the connected source.
The event log does not show credential, permission, scope, or rate-limit errors.
For usage data, confirm that events or usage rows appear for the expected provider, project, account, deployment, model, metric, browser app, desktop app, or user. For organization data, confirm users and app assignments appear. For accounting, confirm expenses appear for the selected categories.
Connected is not the same as active
A source can accept credentials or install successfully before useful data appears. If the connection is marked connected but records are empty, check sync status, agent activity, tracking state, and the event log before replacing credentials.
Pausing and disconnecting
Use pause to stop syncs or activity collection temporarily while keeping the connection. Use disconnect when you want Doow to delete the stored credential or stop reading from the source.
To fully revoke access, also revoke the credential or authorization grant in the provider's own admin settings. For installed agents, also remove or disable the agent through the approved device-management or installation path for your workspace.
Next steps
Open Connecting integrations for the exact connection flow, or return to Choose what to connect if you are still deciding which source to use.