Amplemarket Integration Documentation
Overview
The Amplemarket integration enables you to add leads to sequences for automated multichannel outreach campaigns. This integration leverages Amplemarket's powerful sales engagement platform to streamline your lead nurturing and conversion processes.
Setup
Create the connector
From the settings panel or from the node catalog, search for the Amplemarket integration and navigate to the 'create connector' view.
Retrieve your Amplemarket API key
- Navigate to your Amplemarket dashboard, click on settings, and select API in the left panel
Write Action: Add Leads to Sequence (leadsToSequence)
The write action allows you to add individual leads to existing Amplemarket sequences, enabling automated email and LinkedIn outreach with sophisticated targeting and personalization options.
Configuration
Required Fields
Field | Type | Description |
---|---|---|
Sequence ID | String | The unique identifier of the target sequence in Amplemarket. Use the autocomplete widget to select from your available sequences. |
Expression | The email address of the lead to be added to the sequence. Supports dynamic expressions. | |
LinkedIn URL | Expression | The LinkedIn profile URL of the lead. Required for LinkedIn-based sequence steps. Supports dynamic expressions. |
Optional Fields
Field | Type | Description |
---|---|---|
Data | Array of Objects | Additional lead data fields for personalization and targeting |
Overrides | Array of Objects | Configuration overrides for sequence safety checks |
Leads Distribution | String | Controls how leads are distributed across mailboxes |
Custom Mailboxes | Array | Specific mailboxes to use when leads distribution is set to "customMailboxes" |
Data Fields
The data
array allows you to pass additional information about the lead for enhanced personalization in your sequences:
{
"data": [
{
"name": "company_name",
"value": "Acme Corp"
},
{
"name": "job_title",
"value": "Sales Director"
},
{
"name": "industry",
"value": "SaaS"
}
]
}
Common Data Fields:
company_name
- Lead's company namejob_title
- Lead's job title or positionindustry
- Company industrylocation
- Geographic locationcompany_size
- Number of employeesrevenue
- Annual revenue- Custom fields specific to your use case
Override Options
The overrides
array lets you bypass standard sequence safety checks:
Override | Type | Description |
---|---|---|
ignoreRecentlyContacted | Boolean | Bypass checks for recently contacted leads |
ignoreExecutionList | Boolean | Override exclusion list restrictions |
ignoreDuplicateLeadsInOtherDraftSequences | Boolean | Allow leads present in other draft sequences |
ignoreDuplicateLeadsInOtherActiveSequences | Boolean | Allow leads present in other active sequences |
Example:
{
"overrides": [
{
"name": "ignoreRecentlyContacted",
"value": true
},
{
"name": "ignoreDuplicateLeadsInOtherActiveSequences",
"value": false
}
]
}
Leads Distribution
Controls how leads are distributed across available mailboxes:
sequenceSenders
- Use the sequence's default sender configurationcustomMailboxes
- Specify custom mailboxes for this lead
When using customMailboxes
, provide the mailbox identifiers in the mailboxes
field.
Usage Examples
Basic Lead Addition
{
"objectType": "sequence",
"action": "create",
"sequenceId": "seq_12345",
"email": "john.doe@company.com",
"linkedinUrl": "https://www.linkedin.com/in/johndoe",
"leadsDistribution": "sequenceSenders"
}
Advanced Lead with Data and Overrides
{
"objectType": "sequence",
"action": "create",
"sequenceId": "seq_12345",
"email": "jane.smith@techcorp.com",
"linkedinUrl": "https://www.linkedin.com/in/janesmith",
"data": [
{
"name": "company_name",
"value": "TechCorp Solutions"
},
{
"name": "job_title",
"value": "VP of Engineering"
},
{
"name": "employee_count",
"value": "500-1000"
}
],
"overrides": [
{
"name": "ignoreRecentlyContacted",
"value": true
}
],
"leadsDistribution": "customMailboxes",
"mailboxes": ["mailbox_001", "mailbox_002"]
}
Using Expressions for Dynamic Values
{
"objectType": "sequence",
"action": "create",
"sequenceId": "seq_12345",
"email": "{{lead.email}}",
"linkedinUrl": "{{lead.linkedin_url}}",
"data": [
{
"name": "first_name",
"value": "{{lead.first_name}}"
},
{
"name": "company_name",
"value": "{{lead.company.name}}"
}
]
}
Response Format
Successful executions return information about the operation:
{
"outcome": "executed",
"data": {
"total": 1,
"added": 1,
"skipped": 0,
"errors": []
},
"title": "✅ 1 leads added to sequence"
}
Error Handling
Common error scenarios:
- Invalid Sequence ID: Sequence not found or access denied
- Missing Required Fields: Email or LinkedIn URL not provided
- Duplicate Lead: Lead already exists in sequence (unless overridden)
- Invalid Email Format: Email address format validation failed
- LinkedIn URL Format: Invalid LinkedIn profile URL format
- Mailbox Access: Specified custom mailboxes not accessible
Best Practices
- Data Quality: Ensure email addresses and LinkedIn URLs are valid and properly formatted
- Personalization: Use the
data
array to pass relevant lead information for sequence personalization - Duplicate Management: Configure appropriate override settings based on your outreach strategy
- Mailbox Strategy: Use custom mailboxes strategically to optimize deliverability and sender reputation
- Sequence Selection: Choose sequences appropriate for the lead's profile and stage in your sales funnel
- Testing: Test with a small subset of leads before bulk operations
Integration with Amplemarket Features
This integration supports Amplemarket's key features:
- Multichannel Sequences: Email and LinkedIn outreach
- AI Copywriter: Dynamic personalization using lead data
- Deliverability Optimization: Smart mailbox selection and rotation
- Lead Scoring: Automatic lead qualification based on engagement
- Analytics: Comprehensive tracking and reporting
- Safety Checks: Built-in duplicate and frequency controls
Sequence Types Supported
- Email-only sequences: Traditional email drip campaigns
- LinkedIn-only sequences: Social selling automation
- Multichannel sequences: Combined email and LinkedIn outreach
- AI-generated sequences: Dynamic content based on lead data
Authentication
The integration uses API key authentication. Ensure your Amplemarket API key has the following permissions:
- Read access to sequences
- Write access to sequence leads
- Access to mailbox information (if using custom distribution)
For more information about Amplemarket's sequence capabilities, visit the official documentation.