getaero-io/gtm-eng-skills / skills/deepline-gtm
deepline-gtm
UnverifiedGTM leads, enrichment, outreach, Plays, developer signals/Reo.dev. Providers: adyntel,affinity,ai_ark,akta,allegrow,amplemarket,apify,attention,attio,aviato,bettercontact,bigquery,bluesky,bounceban,brave,browserbase,builtwith,buyercaddy,cbinsights,clay,clickhouse,close,cloudflare,contactout,contextdev,crunchbase,crustdata-v3,customer_db,databricks,dataforseo,datagma,dealroom,deepline_ip_to_company,deepline_native,deeplineagent,deepseek,discolike,dnb,edges,emailbison,emailguard,enformion,enigma,exa,findymail,firecrawl,fireflies,firmable,forager,fullenrich,fundable,generic_http,getleads,gong,google_ads_audiences,google_workspace,govfiles,grain,hackernews,harvestapi,heyreach,hubspot,hunter,icypeas,instantly,intercom,ipqs,kaspr,kernel,kickbox,leadmagic,lemlist,limadata,linkedin_ads_audiences,luma,lusha,meerapi,meta_audiences,millionverifier,nooks,notion,openmart,opensosdata,openwebninja,outreach,parallel,particle,peopledatalabs,pitchbook,podscan,polymarket,postgres,predictleads,prospeo,quickenrich,rapidapi,….
provider-playbooks/smartleads.md
View on GitHubUse Smartlead for outbound email campaign management. Full lifecycle from campaign creation through lead push, scheduling, sequencing, and monitoring.
- Keep activation behind enrichment/verification gates -- only push contacts that have been validated.
- Resolve campaign IDs from `smartlead_list_campaigns` before any write operation.
- Push leads in batches of up to 400 and re-check campaign stats after writes.
- Keep Smartlead traffic at or below 60 requests per 60 seconds per API key. Large pools need queueing or smaller concurrency.
- Always configure sequences and schedule before starting a campaign.
- Include `SMARTLEAD_API_KEY` as fallback env credential when not using org-linked auth.
- Keep payloads provider-native. There is no shared outbound standard contract for Smartlead.
## Workflow
1. **Create or list campaigns** to get a stable campaign ID.
2. **Add email accounts** to the campaign using `smartlead_add_campaign_email_account`.
3. **Configure sequences** with `smartlead_save_campaign_sequences` (email steps, delays, variants).
4. **Set the schedule** with `smartlead_update_campaign_schedule` (timezone, days, hours, send rate).
5. **Configure settings** with `smartlead_update_campaign_settings` (tracking, stop conditions).
6. **Push leads** in batches (max 400) using `smartlead_push_to_campaign`.
7. **Start the campaign** with `smartlead_update_campaign_status` (status: `START`).
8. **Monitor** via `smartlead_get_campaign_stats` and `smartlead_get_campaign_analytics`.
## Quick Reference
### Campaigns
```bash
deepline run smartlead_list_campaigns --input '{}'
deepline run smartlead_create_campaign --input '{"name":"Insurance Brokerage - Book Assessment"}' --dry-run
deepline run smartlead_create_campaign --input '{"name":"Insurance Brokerage - Book Assessment"}'
deepline run smartlead_get_campaign --input '{"campaign_id":12345678}'
# smartlead_clone_campaign is disabled pending live contract verification.
deepline run smartlead_update_campaign_status --input '{"campaign_id":12345678,"status":"START"}' --dry-run
deepline run smartlead_update_campaign_status --input '{"campaign_id":12345678,"status":"START"}'
deepline run smartlead_delete_campaign --input '{"campaign_id":12345678}' --dry-run
deepline run smartlead_delete_campaign --input '{"campaign_id":12345678}'
```
### Leads
```bash
deepline run smartlead_push_to_campaign --input '{"campaign_id":"12345678","lead_list":[{"email":"jane@example.com","first_name":"Jane","last_name":"Lovelace","company_name":"Acme Corp","custom_fields":{"tag":"demo"}}]}' --dry-run
deepline run smartlead_push_to_campaign --input '{"campaign_id":"12345678","lead_list":[{"email":"jane@example.com","first_name":"Jane","last_name":"Lovelace","company_name":"Acme Corp","custom_fields":{"tag":"demo"}}]}'
deepline run smartlead_list_campaign_leads --input '{"campaign_id":12345678,"offset":0,"limit":100}'
deepline run smartlead_fetch_lead_by_email --input '{"email":"jane@example.com"}'
deepline run smartlead_update_lead_by_campaign --input '{"campaign_id":12345678,"lead_id":1,"email":"jane@example.com","first_name":"Updated"}' --dry-run
deepline run smartlead_update_lead_by_campaign --input '{"campaign_id":12345678,"lead_id":1,"email":"jane@example.com","first_name":"Updated"}'
deepline run smartlead_pause_lead_by_campaign --input '{"campaign_id":12345678,"lead_id":1}' --dry-run
deepline run smartlead_pause_lead_by_campaign --input '{"campaign_id":12345678,"lead_id":1}'
deepline run smartlead_resume_lead_by_campaign --input '{"campaign_id":12345678,"lead_id":1}' --dry-run
deepline run smartlead_resume_lead_by_campaign --input '{"campaign_id":12345678,"lead_id":1}'
deepline run smartlead_unsubscribe_lead --input '{"lead_id":1}' --dry-run
deepline run smartlead_unsubscribe_lead --input '{"lead_id":1}'
deepline run smartlead_export_campaign_leads --input '{"campaign_id":12345678}'
```
### Sequences
```bash
deepline run smartlead_fetch_campaign_sequences --input '{"campaign_id":12345678}'
deepline run smartlead_save_campaign_sequences --input '{"campaign_id":12345678,"sequences":[{"seq_number":1,"seq_delay_details":{"delay_in_days":0},"seq_variants":[{"email_body":"<p>Hello Ada</p>","variant_label":"A","subject":"Quick question"}]},{"seq_number":2,"seq_delay_details":{"delay_in_days":3},"seq_variants":[{"email_body":"<p>Following up</p>","variant_label":"A","subject":"Re: Quick question"}]}]}' --dry-run
deepline run smartlead_save_campaign_sequences --input '{"campaign_id":12345678,"sequences":[{"seq_number":1,"seq_delay_details":{"delay_in_days":0},"seq_variants":[{"email_body":"<p>Hello Ada</p>","variant_label":"A","subject":"Quick question"}]},{"seq_number":2,"seq_delay_details":{"delay_in_days":3},"seq_variants":[{"email_body":"<p>Following up</p>","variant_label":"A","subject":"Re: Quick question"}]}]}'
```
### Schedule and Settings
```bash
deepline run smartlead_update_campaign_schedule --input '{"campaign_id":12345678,"timezone":"America/New_York","days_of_the_week":[1,2,3,4,5],"start_hour":"09:00","end_hour":"17:00","min_time_btw_emails":5,"max_new_leads_per_day":20}' --dry-run
deepline run smartlead_update_campaign_schedule --input '{"campaign_id":12345678,"timezone":"America/New_York","days_of_the_week":[1,2,3,4,5],"start_hour":"09:00","end_hour":"17:00","min_time_btw_emails":5,"max_new_leads_per_day":20}'
deepline run smartlead_update_campaign_settings --input '{"campaign_id":12345678,"track_settings":["DONT_TRACK_EMAIL_OPEN"],"stop_lead_settings":"REPLY_TO_AN_EMAIL"}' --dry-run
deepline run smartlead_update_campaign_settings --input '{"campaign_id":12345678,"track_settings":["DONT_TRACK_EMAIL_OPEN"],"stop_lead_settings":"REPLY_TO_AN_EMAIL"}'
```
### Analytics
```bash
deepline run smartlead_get_campaign_stats --input '{"campaign_id":12345678}'
deepline run smartlead_get_campaign_analytics --input '{"campaign_id":12345678}'
deepline run smartlead_get_campaign_analytics_by_date --input '{"campaign_id":12345678,"start_date":"2026-01-01","end_date":"2026-01-30"}'
deepline run smartlead_get_lead_statistics --input '{"campaign_id":12345678}'
```
### Email Accounts
```bash
deepline run smartlead_list_email_accounts --input '{}'
deepline run smartlead_add_campaign_email_account --input '{"campaign_id":12345678,"email_account_ids":[1,2,3]}' --dry-run
deepline run smartlead_add_campaign_email_account --input '{"campaign_id":12345678,"email_account_ids":[1,2,3]}'
deepline run smartlead_remove_campaign_email_account --input '{"campaign_id":12345678,"email_account_ids":[3]}' --dry-run
deepline run smartlead_remove_campaign_email_account --input '{"campaign_id":12345678,"email_account_ids":[3]}'
deepline run smartlead_update_email_account_warmup --input '{"email_account_id":1,"warmup_enabled":true,"total_warmup_per_day":20,"daily_rampup":2,"reply_rate_percentage":30}' --dry-run
deepline run smartlead_update_email_account_warmup --input '{"email_account_id":1,"warmup_enabled":true,"total_warmup_per_day":20,"daily_rampup":2,"reply_rate_percentage":30}'
```
### Block List
```bash
deepline run smartlead_add_domain_block_list --input '{"domain_block_list":["competitor.com","spam@bad.org"]}' --dry-run
deepline run smartlead_add_domain_block_list --input '{"domain_block_list":["competitor.com","spam@bad.org"]}'
deepline run smartlead_get_block_list --input '{"limit":50,"filter_email_or_domain":"example.com"}'
```
### Smart Delivery
```bash
deepline run smartlead_get_delivery_test --input '{"test_id":1}'
# smartlead_create_delivery_test and smartlead_get_delivery_score are disabled pending live contract verification.
```
### Smart Senders (Domains)
```bash
deepline run smartlead_search_domain --input '{"domain_name":"example.com","vendor_id":1}'
# smartlead_add_domain and smartlead_verify_domain are disabled pending live contract verification.
deepline run smartlead_auto_generate_mailboxes --input '{"vendor_id":1,"domains":{"example.com":{"count":5}}}' --dry-run
deepline run smartlead_auto_generate_mailboxes --input '{"vendor_id":1,"domains":{"example.com":{"count":5}}}'
```
## Response Shape Contract
`deepline run` saves the tool response as the data file its receipt names (`--json-out <path>` chooses the file). Its contents by tool:
- `smartlead_list_campaigns` -> an array of Smartlead campaign objects with stable `id`, `name`, and `status` fields plus the upstream metadata returned by Smartlead.
- `smartlead_get_campaign_stats` -> contains `{ sent, opened, clicked, replied, bounced }`, mapped from Smartlead `/analytics` root counters.
- `smartlead_push_to_campaign` -> contains `{ pushed, failed, results }`.
- `smartlead_create_campaign` -> includes `{ ok, id, name, created_at }`.
- `smartlead_export_campaign_leads` -> raw CSV text.
- `smartlead_list_campaign_leads` -> a paginated list of lead objects.
- `smartlead_get_campaign_analytics_by_date` -> contains daily stats breakdown.
## Gotchas
- **`min_time_btw_emails` vs `min_time_btwn_emails`:** The schedule endpoint accepts both field names. `min_time_btw_emails` is canonical; `min_time_btwn_emails` is the legacy alias. At least one must be provided. The validator normalizes the legacy alias to the canonical field.
- **Campaign status values:** Only `PAUSED`, `STOPPED`, and `START` are valid. Note it is `START`, not `STARTED` or `RUNNING`.
- **Timezone handling:** `update_campaign_schedule` requires an IANA timezone string (e.g. `America/New_York`). The schedule uses 24-hour `HH:MM` format for `start_hour` and `end_hour`, and `start_hour` must be strictly before `end_hour`.
- **Days of the week:** 0 = Sunday through 6 = Saturday. At least one day is required.
- **Sequence ordering:** `seq_number` values must be contiguous starting at 1 (no gaps). The first sequence step (seq_number 1) must have a subject line (either at step level or on every variant).
- **Delay units:** `delay_in_days` is in days (0 = immediate). Do not pass hours or minutes.
- **Lead batch limits:** Maximum 400 leads per `push_to_campaign` call. Use `lead_list` as the canonical field; Deepline still accepts `leads` as a compatibility alias. Duplicate emails within a batch are rejected. Emails are automatically lowercased for deduplication.
- **Provider rate limit:** Smartlead currently documents 60 requests per 60 seconds per API key. Avoid high parallelism on campaign mutations unless you add queueing or backoff.
- **Analytics date range:** `get_campaign_analytics_by_date` enforces a maximum 30-day window between `start_date` and `end_date`. Dates must be in `YYYY-MM-DD` format.
- **Track settings normalization:** `update_campaign_settings` accepts either a single string or an array for `track_settings`. Valid values: `DONT_TRACK_EMAIL_OPEN`, `DONT_TRACK_LINK_CLICK`, `DONT_TRACK_REPLY_TO_AN_EMAIL`.
- **Stop lead settings:** Valid values: `REPLY_TO_AN_EMAIL`, `CLICK_ON_A_LINK`, `OPEN_AN_EMAIL`.
- **Block list entries:** Each entry must be a valid domain (`example.com`) or email address (`user@example.com`). URLs with protocol prefixes or paths are rejected.
- **Lead fetch by email:** Smartlead returns HTTP `200 {}` for missing or malformed emails. Deepline converts that upstream empty-object case into `no_result`.
- **Campaign unsubscribe:** Smartlead can return HTTP `200 {"ok":false}` for an unknown lead. Deepline treats that as an explicit failure rather than a successful unsubscribe.
- **Campaign lead export:** The export endpoint returns `text/csv`, so downstream steps should parse the data as CSV text, not JSON.
- **Webhook event types:** `EMAIL_SENT`, `EMAIL_OPEN`, `EMAIL_LINK_CLICK`, `EMAIL_REPLY`, `LEAD_UNSUBSCRIBED`, `LEAD_CATEGORY_UPDATED`.
- **Campaign IDs:** Accepted as integer or numeric string. Non-numeric strings are rejected.
- **Reply thread:** `reply_email_time` must be a full ISO datetime (e.g. `2026-01-15T09:30:00.000Z`). Date-only strings are rejected.
- **Client permissions:** Only `reply_master_inbox` and `full_access` are valid. Client passwords must be at least 8 characters.
- **API key auth:** Pass `SMARTLEAD_API_KEY` environment variable. The API key is appended as a query parameter by the integration layer.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| deprecation-and-migrationaddyosmani/agent-skillsManages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| performance-optimizationaddyosmani/agent-skillsOptimizes application performance across frontend, backend, queries, and databases. Use when performance requirements exist, when you suspect performance regressions, when Core Web Vitals or load times need improvement, when N+1 query patterns need fixing, or when profiling reveals bottlenecks. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| agent-cost-reportthedotmack/claude-memBelievable agent cost report for any period, default the last 7 full days PT, not counting today. Measured tokens from Claude Code transcripts priced at OpenRouter list prices (ESTIMATED), measured provider spend when a sanctioned source exists, note-taker cost separate, Timing-style HTML/PDF plus report.json, line-items.csv, evidence.json. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |