Skip to main content
Connect a provider that authenticates with an API key or token (e.g. Apollo, Prospeo, Instantly, a HubSpot private-app token, Pipedrive, Attio, Smartlead, HeyReach). Ask the user for the key, then call this — it verifies the credentials against the provider before saving and stores them encrypted.
Providers that use a browser sign-in (OAuth, e.g. Gmail) can’t be connected this way — the tool returns guidance to connect those on the Integrations page. That single OAuth click is the only human step left in setup.

​
Parameters

​
Returns

If the provider uses OAuth, or the key doesn’t verify:

​
When to call it

  • When the user gives you an API key for an enrichment, CRM, or sequencer tool.
  • After connecting an enrichment provider, the context graph starts filling in.

​
Backed by

POST /v2/workspace/integrations — the agent setup surface. Logged to the Ops page.