Who can manage integrations?
Workspace owners and admins can connect, change credentials, enable or disable, and disconnect integrations. Members can use available workspace connections, subject to the selected action’s access requirements; ask an owner or admin to change the setup. These permissions apply in the web app, CLI, SDK, and API. Provider authorization also requires access to the provider account.Check the workspace and tool
Use a tool ID returned by search:connected, credentialStatus,
and byok. Required BYOK means the tool needs your own provider account;
optional BYOK allows managed access when no account is connected. If the tool
lists a byok feature, read its setup instructions with
deepline describe <tool-id> --feature byok.
Connect the account
- Web app
- CLI credential file
- Have an owner or admin select the intended workspace and open Integrations.
- Search for the provider and choose Connect. Complete its authorization flow or credential form, including every required field.
- Check the connection’s status and use Test where offered. Resolve any reconnect or validation error, then return to the agent to verify access.
Verify access
Describe the same tool again in the same workspace. Checkconnected and any
credential error. A successful connection applies only to the actions and access
modes that support it. For a live check, review the tool’s inputs and pricing
before running a small request; saving credentials alone does not run a lookup.
If a request fails with an authorization or scope error, resolve that access
failure before retrying. Report it separately from a valid no-match result.
Before replacing or disconnecting a provider
Before replacing or disconnecting a provider
- Inventory dependent Plays, Monitors, identifiers, joins, field meanings, rate limits, permissions, and managed/BYOK requirements.
- Compare providers on the same dated records and acceptance rule, including regional coverage and identity inputs. Measure additional accepted results and recorded usage; preserve the original output as the baseline.
- Verify replacement access, then switch consumers and check their results. Preserve source and observation time on existing values, and keep a rollback path until the dependent workflows pass.
- Review remaining consumers before retiring the old connection. Provider agreements and data-use permissions remain your team’s responsibility.
CRM integrations
For Affinity, Attio, HubSpot, Pipedrive, Salesforce, or Zoho CRM, check the connection’s availability and the selected action’s current contract. Connection access does not authorize arbitrary record changes. Use Repair CRM records for destination IDs, HubSpot properties, Attio attributes, approved changes, and read-back.Connection availability
A saved connection grants only the actions exposed by the public tool catalog. Google Sheets OAuth can connect an account that owns or can edit a sheet; share that sheet with the connected account when needed. It currently exposes no publicgoogle_sheets_* actions. Use CSV input or the
Database for a callable Deepline data workflow.
Specialized credential procedures are in the shared reference:
Meta system user token and
external Postgres/Supabase.