Skip to content

Handle methods: connect

The Handle Verbs connect as typed SDK methods, with inputs, result, refusals and an example.

Reference for Handle, one group of Handle methods.

Handle.connect

Connect binds a Handle to the Integration credential it publishes through, once the platform confirms the account. Verb page.

TypeScript
interface HandleVerbs {
  connect(input: HandleConnectInput, options?: SB.CallOptions): SB.Call<Handle>
}

Emits Handle.connected.

Inputs

InputTypeRequiredDescription
handleHandlerequiredThe Handle.
integrationIntegrationrequiredThe Integration credential.

Returns

OutputTypeRequiredDescription
handleHandlerequiredThe connected Handle.

Refuses when

CheckErrorFixThen call
The key is valid, but its scopes do not allow this operation.forbiddenUse a key whose scopes cover the operation, or ask an owner of the namespace to grant them.None.

Example

TypeScript
import { $ } from 'startup-builder'

const handle = await $.Handle.connect({ handle: 'handle_FcnNwYQujc', integration: 'integration_alVwjQcmRy' })