Woodpecker Campaign Setup Skill

This skill provides the definitive workflow for creating a Woodpecker campaign using the V2 API and correctly enrolling prospects using the V1 API, ensuring visual linkage and account signatures.

Quick Start

1. Get your API Key from Woodpecker (Settings > Marketplace > API keys).
2. Find your Email Account ID (needed for campaign creation).
3. Use the scripts in this skill to automate the 2-step process.

Key Findings & Gotchas

• API Splitting: Campaign creation should use V2 (/rest/v2/campaigns). Prospect enrollment MUST use V1 (/rest/v1/add_prospects_campaign).
• The Linkage Secret: To make prospects appear in the Woodpecker dashboard for a V2 campaign, you must nest the campaign_id inside a campaign object in the enrollment payload.
• Signature Handling: Setting "signature": "SENDER" in the V2 step body uses the account's configured professional signature automatically.
• Status & Force: Always set prospect status to ACTIVE and use force: True in the enrollment payload to override any prior global status.

Workflow Patterns