> ## Documentation Index
> Fetch the complete documentation index at: https://docs.revoengine.com/llms.txt
> Use this file to discover all available pages before exploring further.

# vault.connectIntegration()

> Public low-code contract, signatures and examples for vault.connectIntegration.

## `vault.connectIntegration()`

Saves the guarded definition and starts interactive OAuth. Returns an authorization URL;
the verified initiating user completes consent through the existing frontend callback.
Instance scope requires a verified personal instance administrator. Unavailable with `readOnly: true` (throws an error).

### Signature

```ts theme={null}
static connectIntegration(name: string, data: VaultConnectIntegrationInput, options?: SecretScopeOptions): Promise<VaultIntegrationConnectResult | null>;
```

### Example

```ts theme={null}
const pending = await vault.connectIntegration('CRM', {
  resourceUrl: input.resourceUrl, scopes: ['read'], expectedRevision: null,
}, { scope: 'user' });
```

See [all vault methods](https://docs.revoengine.com/low-code/reference/vault.md) or [runtime basics](https://docs.revoengine.com/low-code/overview.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.