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

Setup step 1

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

FieldTypeDescription
Sequence IDStringThe unique identifier of the target sequence in Amplemarket. Use the autocomplete widget to select from your available sequences.
EmailExpressionThe email address of the lead to be added to the sequence. Supports dynamic expressions.
LinkedIn URLExpressionThe LinkedIn profile URL of the lead. Required for LinkedIn-based sequence steps. Supports dynamic expressions.

Optional Fields

FieldTypeDescription
DataArray of ObjectsAdditional lead data fields for personalization and targeting
OverridesArray of ObjectsConfiguration overrides for sequence safety checks
Leads DistributionStringControls how leads are distributed across mailboxes
Custom MailboxesArraySpecific 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 name
  • job_title - Lead's job title or position
  • industry - Company industry
  • location - Geographic location
  • company_size - Number of employees
  • revenue - Annual revenue
  • Custom fields specific to your use case

Override Options

The overrides array lets you bypass standard sequence safety checks:

OverrideTypeDescription
ignoreRecentlyContactedBooleanBypass checks for recently contacted leads
ignoreExecutionListBooleanOverride exclusion list restrictions
ignoreDuplicateLeadsInOtherDraftSequencesBooleanAllow leads present in other draft sequences
ignoreDuplicateLeadsInOtherActiveSequencesBooleanAllow 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 configuration
  • customMailboxes - 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

  1. Data Quality: Ensure email addresses and LinkedIn URLs are valid and properly formatted
  2. Personalization: Use the data array to pass relevant lead information for sequence personalization
  3. Duplicate Management: Configure appropriate override settings based on your outreach strategy
  4. Mailbox Strategy: Use custom mailboxes strategically to optimize deliverability and sender reputation
  5. Sequence Selection: Choose sequences appropriate for the lead's profile and stage in your sales funnel
  6. 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.