cold-emailGenerate hyper-personalized cold email sequences using AI. Turn lead data into high-converting outreach campaigns.
Install via ClawdBot CLI:
clawdbot install Bluecraft-AI/cold-emailGenerate personalized cold email sequences from lead data. MachFive uses AI to research prospects and craft unique, relevant outreach - not templates.
MACHFIVE_API_KEY in your environmentEvery generate request needs a campaign ID in the URL: /api/v1/campaigns/{campaign_id}/generate (or /generate-batch).
List campaigns in the workspace so the agent can ask the user which campaign to use when they haven't provided a name or ID.
GET https://app.machfive.io/api/v1/campaigns
Authorization: Bearer {MACHFIVE_API_KEY}Or use X-API-Key: {MACHFIVE_API_KEY} header.
Optional query: ?q=search or ?name=search to filter by campaign name.
Response (200):
{
"campaigns": [
{ "id": "cb1bbb14-e576-4d8f-a8f3-6fa929076fd8", "name": "SaaS Q1 Outreach", "created_at": "2025-01-15T12:00:00Z" },
{ "id": "a1b2c3d4-...", "name": "Enterprise Leads", "created_at": "2025-01-10T08:00:00Z" }
]
}If no campaign name or ID was given, call this first, then ask the user: "Which campaign should I use? [list names/IDs]."
Generate an email sequence for one lead (3–5 emails per lead). Waits for completion, returns the sequence directly. The request can take 3–5 minutes (AI research + generation); use a client timeout of at least 300 seconds (5 min) or 600 seconds (10 min). Do not use a 120s timeout or the response will be cut off.
POST https://app.machfive.io/api/v1/campaigns/{campaign_id}/generate
Authorization: Bearer {MACHFIVE_API_KEY}
Content-Type: application/jsonOr use X-API-Key: {MACHFIVE_API_KEY} header.
{
"lead": {
"name": "John Smith",
"title": "VP of Marketing",
"company": "Acme Corp",
"email": "john@acme.com",
"company_website": "https://acme.com",
"linkedin_url": "https://linkedin.com/in/johnsmith"
},
"options": {
"list_name": "Q1 Outreach",
"email_count": 3,
"email_signature": "Best,\nYour Name",
"approved_ctas": ["Direct Meeting CTA", "Lead Magnet CTA"]
}
}Response (200):
{
"lead_id": "lead_xyz789",
"list_id": "uuid",
"sequence": [
{ "step": 1, "subject": "...", "body": "..." },
{ "step": 2, "subject": "...", "body": "..." },
{ "step": 3, "subject": "...", "body": "..." }
],
"credits_remaining": 94
}Recovery: The response includes list_id. If the request times out or the response is truncated, you can still get the result: call GET /api/v1/lists/{list_id} to confirm status, then GET /api/v1/lists/{list_id}/export?format=json to retrieve the sequence.
Generate email sequences for multiple leads (one list; each lead gets a sequence). Returns immediately (202) with list_id; processing runs in the background. To get results: poll list status, then call export.
POST https://app.machfive.io/api/v1/campaigns/{campaign_id}/generate-batch
Authorization: Bearer {MACHFIVE_API_KEY}
Content-Type: application/jsonOr use X-API-Key: {MACHFIVE_API_KEY} header.
{
"leads": [
{ "name": "John Smith", "email": "john@acme.com", "company": "Acme Corp", "title": "VP Marketing" },
{ "name": "Jane Doe", "email": "jane@beta.com", "company": "Beta Inc", "title": "Director Sales" }
],
"options": {
"list_name": "Q1 Outreach Batch",
"email_count": 3
}
}Response (202):
{
"list_id": "uuid",
"status": "processing",
"leads_count": 2,
"message": "Batch accepted. Poll list status or open in UI."
}List lead lists in the workspace. Optional query: campaign_id, status (pending | processing | completed | failed), limit (default 50, max 100), offset.
GET https://app.machfive.io/api/v1/lists
GET https://app.machfive.io/api/v1/lists?campaign_id={campaign_id}&status=completed&limit=20
Authorization: Bearer {MACHFIVE_API_KEY}Response (200): { "lists": [ { "id", "campaign_id", "custom_name", "processing_status", "created_at", "completed_at" }, ... ] }. Order is created_at desc.
Poll until the list is done. Use the list_id from generate or generate-batch.
GET https://app.machfive.io/api/v1/lists/{list_id}
Authorization: Bearer {MACHFIVE_API_KEY}Response (200): id, campaign_id, custom_name, processing_status (pending | processing | completed | failed), created_at, updated_at. When processing_status === 'completed': leads_count, emails_created, completed_at. When failed: failed_at. 404 if list not found or not in workspace.
Poll every 10–30 seconds until processing_status === 'completed' or failed. If failed, the list cannot be exported; retry by submitting a new batch.
After status is completed, fetch the processed output. CSV (default) or JSON.
GET https://app.machfive.io/api/v1/lists/{list_id}/export?format=csv
GET https://app.machfive.io/api/v1/lists/{list_id}/export?format=json
Authorization: Bearer {MACHFIVE_API_KEY}Content-Disposition: attachment; filename="MachFive-{list_id}.csv".{ "leads": [ { "email": "...", "sequence": [ { "step": 1, "subject": "...", "body": "..." }, ... ] }, ... ] }. Each lead may include optional name, company, title when present, e.g. { "email": "john@acme.com", "name": "John Smith", "company": "Acme Corp", "title": "VP Marketing", "sequence": [ ... ] }.Batch flow: POST generate-batch → 202 + list_id → poll GET /lists/:id until processing_status === 'completed' → GET /lists/:id/export?format=csv or json → return result to user.
Each lead must include a valid email; it is used to map the lead through processing and to match generated sequences back to the lead in exports (same as the app UI). All other fields are optional but improve personalization.
| Field | Required | Description |
|-------|----------|-------------|
| email | Yes | Lead's email address; used to map the lead through processing and in exports |
| name | No | Full name or first name (improves personalization) |
| company | No | Company name (improves personalization) |
| title | No | Job title (improves personalization) |
| company_website | No | Company URL for research |
| linkedin_url | No | LinkedIn profile for deeper personalization |
| Option | Type | Default | Description |
|--------|------|---------|-------------|
| list_name | string | Auto | Display name for this list in MachFive UI |
| email_count | number | 3 | Emails per lead (1-5) |
| email_signature | string | None | Signature appended to emails |
| campaign_angle | string | None | Context for personalization |
| approved_ctas | array | From campaign | CTAs to use (omit to use campaign defaults) |
processing_status is completed or failed. Workspaces have a concurrent batch limit; if you get 429, retry later.limit default 50, max 100; offset for pagination.| Code | Error | Description |
|------|-------|-------------|
| 400 | BAD_REQUEST | Invalid JSON, missing lead/leads, or missing/invalid lead email; or campaign has no vector store |
| 401 | UNAUTHORIZED | Invalid or missing API key |
| 402 | INSUFFICIENT_CREDITS | Out of credits |
| 403 | FORBIDDEN | Campaign not in your workspace |
| 404 | NOT_FOUND | Campaign or list doesn't exist |
| 409 | NOT_READY | Export called before list completed (poll GET /lists/:id first) |
| 429 | WORKSPACE_LIMIT | Too many concurrent batch jobs; try again later |
"Generate a cold email for the VP of Sales at Stripe"
"Create outreach sequences for these 10 leads"
"Write a 3-email sequence targeting marketing directors at SaaS companies"
Get started: https://machfive.io
Generated Mar 1, 2026
A sales team at a SaaS company uses MachFive to generate personalized cold email sequences for targeting enterprise leads. They input lead data like job titles and company websites, and the AI researches prospects to craft emails that reference recent company news or specific pain points, increasing reply rates for demos.
A digital marketing agency leverages MachFive to automate outreach to potential clients in niche industries. By providing lead details such as LinkedIn profiles, the tool generates hyper-personalized email sequences that highlight the agency's relevant case studies, helping secure initial consultations.
A recruitment firm uses MachFive to create tailored outreach emails for passive job candidates. The AI analyzes candidates' profiles and company backgrounds to draft sequences that emphasize career opportunities and company culture, improving engagement for hard-to-fill roles.
An e-commerce business employs MachFive to reach out to potential suppliers or manufacturers. By inputting lead information, the tool generates emails that personalize based on the supplier's product lines and market position, facilitating partnership discussions and bulk order negotiations.
A nonprofit organization uses MachFive to craft personalized email sequences for donor outreach. The AI researches potential donors' philanthropic interests and past contributions, creating emails that align with the nonprofit's mission to increase donation rates.
MachFive operates as a subscription-based SaaS tool where users pay monthly or annual fees for access to AI-powered cold email generation. Revenue is generated through tiered pricing plans based on usage limits, such as the number of leads or emails per month, appealing to businesses of all sizes.
The platform uses a credit-based system where users purchase credits to generate email sequences, with each lead consuming a set number of credits. This model allows for flexible pay-as-you-go pricing, generating revenue from both occasional users and high-volume clients without long-term commitments.
MachFive offers enterprise licensing deals for large organizations requiring custom integrations, higher volume limits, and dedicated support. Revenue comes from annual contracts that include advanced features like API access and priority processing, targeting corporations with extensive outreach needs.
💬 Integration Tip
Ensure the AI agent handles long timeouts of 5-10 minutes for single lead generation and implements polling for batch processing to avoid response truncation.
Marketing Mode combines 23 comprehensive marketing skills covering strategy, psychology, content, SEO, conversion optimization, and paid growth. Use when users need marketing strategy, copywriting, SEO help, conversion optimization, paid advertising, or any marketing tactic.
Access 23 marketing modules offering checklists, frameworks, and ready-to-use deliverables for CRO, SEO, copywriting, analytics, launches, ads, and social me...
SEO specialist agent with site audits, content writing, keyword research, technical fixes, link building, and ranking strategies.
Perform deep SEO competitor analysis, including keyword research, backlink checking, and content strategy mapping. Use when the user wants to analyze a website's competitors or improve their own SEO ranking by studying the competition.
Query Google Search Console for SEO data - search queries, top pages, CTR opportunities, URL inspection, and sitemaps. Use when analyzing search performance,...
Run local SEO autopilot for boll-koll.se or hyresbyte.se and return PR link plus summary.