Account Management

Connect an API-key integration

Connect (or re-key) an API-key integration so signals can push leads to it. The key is validated with the provider before it's stored, and encrypted at rest.

Input: apiKey (required), optional label; Gong also takes secret + baseUrl.

Output: the provider's connection status.

Providers: instantly, lemlist, smartlead, emelia, lagrowthmachine, gong, claap. OAuth providers (hubspot, pipedrive, google_sheets, slack) return 400 USE_DASHBOARD_OAUTH — connect them once in the dashboard, then select them per signal via destinations.

put/api/v1/integrations/{provider}

Request

  • Base URL: https://api.rodz.io (the document declares no server; this is the origin it was published from)
  • URL: https://api.rodz.io/api/v1/integrations/{provider}
  • Auth: HTTP bearer

Path parameters

providerstring required

Request body

apiKeystring required

The provider API key.

labelstring nullable

Optional name to tell apart multiple connected accounts of this provider.

secretstring nullable

Gong only: signing secret.

baseUrlstring nullable

Gong only: API base URL.

Example request

{
  "apiKey": "sk_live_a1b2c3d4e5",
  "label": "Acme — main"
}

Response

Successful Response

providerstring required

Provider id to use in destinations + connect URLs.

namestring required

Human-readable provider name.

connectedboolean required

Whether this provider is connected on your account.

labelstring nullable

Account label, if set.

connectViastring required

How to connect: "api" (key) or "dashboard" (OAuth).

updatedAtstring nullable

Example response

{
  "connectVia": "api",
  "connected": true,
  "label": "Acme — main",
  "name": "Instantly",
  "provider": "instantly",
  "updatedAt": "2026-07-15T10:00:00+00:00"
}

Changes

No recorded changes to this operation across all 1 revision of this API.