# Connected tools

URL: /products/app/integrations-in-your-app · Id: `page:products/app/integrations-in-your-app`

> How a Customer connects its own outside tools to an App, what the App may do with them, and how the Customer takes the access back.

A Customer-scope [Integration](/business/nouns/integration) connects one [Customer](/business/nouns/customer)'s own account at another tool to its [Tenant](/business/nouns/tenant). The [App](/business/nouns/app) then acts in that tool on the Customer's behalf, with only the grants the Customer approved.

## Connect
[`Integration.connect`](/business/nouns/integration/connect) asks the account holder to approve the outside account and records the grants they approve. Harbor Residential connects its calendar, so each renewal's signing date lands on the manager's calendar.

The token is filled in at call time and never reaches an [Agent](/business/nouns/agent) or a screen. The App's code calls the Integration, never the tool directly, so the same call works for every Customer whatever tool it connected.

## Keep it working
| [Verb](/business/nouns/verb) | When it runs |
| --- | --- |
| [`Integration.refresh`](/business/nouns/integration/refresh) | Before the outside token expires; a refused refresh moves it to `needsReauth` |
| [`Integration.reconnect`](/business/nouns/integration/reconnect) | When the Customer re-approves, keeping its id and cursor, so nothing re-imports |
| [`Integration.pause`](/business/nouns/integration/pause) | When the Customer wants calls stopped, keeping token and cursor |
| [`Integration.resume`](/business/nouns/integration/resume) | To restart from the cursor and release each [Action](/business/nouns/action) that waited |

An Integration in `needsReauth` shows on the Tenant's integrations screen until the Customer reconnects it.

## Take it back
[`Integration.revoke`](/business/nouns/integration/revoke) ends the Integration at once and revokes the token with the outside tool. Every record it brought in stays in the Tenant, with its history.

## Next
[Audit log for admins](/products/app/audit-log-for-admins) covers what a Customer's admins see of every call.