Skip to main content
Use Smartlead to manage campaign state and push reviewed contacts into a campaign. This page documents the Smartlead-specific contract; the API reference documents Deepline authentication and execution envelopes.

​
Connect Smartlead

In the Deepline dashboard, open Integrations → Smartlead, add the API key for the intended Smartlead workspace, then run the connection test. Resolve the campaign ID with smartlead_list_campaigns before any write.

​
Live actions and schema

Execute these IDs through the shared POST /api/v2/integrations/{toolId}/execute contract. The table lists payload fields. Substitute an Action ID from it into GET /api/v2/integrations/{toolId}/get to inspect the live schema. leads is accepted as a compatibility alias, but use lead_list in new requests. Deepline lowercases and rejects duplicate emails within a batch.

​
Campaign safeguards

  • Push only contacts that have passed the appropriate enrichment, validation, suppression, and approval gate.
  • Before smartlead_update_campaign_status with START, configure the sending account, sequence, schedule, and stop conditions with the matching smartlead_* actions. Starting a campaign can send email.
  • Keep each batch within the limit returned by the live schema. Read campaign state and lead results before repeating an ambiguous write.
  • Handle large writes sequentially and use backoff when the provider asks you to slow down.