> Markdown versions of all pages of this connector library are available by appending `.md` to the page URL. For the full index of connectors, see [llms.txt](https://connectors.appmixer.com/llms.txt).

# Woodpecker connector

- Connector: `appmixer.woodpecker`
- Version: 1.1.1
- Components: 27 (10 triggers, 17 actions)

Woodpecker.co is a cold-email and sales-outreach platform. Automate campaigns, prospects, mailboxes and react to outreach events in real time.

- Connector page: <https://connectors.appmixer.com/connector/appmixer.woodpecker/1.1.1>
- Documentation: <https://docs.appmixer.com/connector-configuration/woodpecker>
- Source code: <https://github.com/clientIO/appmixer-connectors/tree/dev/src/appmixer/woodpecker>
- Download package: <https://connectors.appmixer.com/connector/appmixer.woodpecker/1.1.1/download>

## Authentication

**Type:** API Key

**Fields:**

- `API Key` (password): Log into your Woodpecker panel and go to **Add-ons → API & Integrations → API keys**, then create a key. The "API keys & integrations" add-on is required (included during trial, paid add-on on regular plans).

## Triggers (10)

- [Campaign Completed](https://connectors.appmixer.com/connector/appmixer.woodpecker/1.1.1/component/appmixer.woodpecker.core.CampaignCompleted.md) (`appmixer.woodpecker.core.CampaignCompleted`): Triggers when a campaign is completed.
- [Email Opened](https://connectors.appmixer.com/connector/appmixer.woodpecker/1.1.1/component/appmixer.woodpecker.core.EmailOpened.md) (`appmixer.woodpecker.core.EmailOpened`): Triggers when a prospect opens a tracked email. Open tracking must be enabled on the campaign.
- [Email Sent](https://connectors.appmixer.com/connector/appmixer.woodpecker/1.1.1/component/appmixer.woodpecker.core.EmailSent.md) (`appmixer.woodpecker.core.EmailSent`): Triggers when a campaign email is sent to a prospect.
- [Link Clicked](https://connectors.appmixer.com/connector/appmixer.woodpecker/1.1.1/component/appmixer.woodpecker.core.LinkClicked.md) (`appmixer.woodpecker.core.LinkClicked`): Triggers when a prospect clicks a tracked link in a campaign email.
- [New Prospect Saved](https://connectors.appmixer.com/connector/appmixer.woodpecker/1.1.1/component/appmixer.woodpecker.core.NewProspectSaved.md) (`appmixer.woodpecker.core.NewProspectSaved`): Triggers when a new prospect is saved or updated.
- [New Reply](https://connectors.appmixer.com/connector/appmixer.woodpecker/1.1.1/component/appmixer.woodpecker.core.NewReply.md) (`appmixer.woodpecker.core.NewReply`): Triggers when a prospect replies to a campaign message (or is manually marked as responded).
- [Prospect Bounced](https://connectors.appmixer.com/connector/appmixer.woodpecker/1.1.1/component/appmixer.woodpecker.core.ProspectBounced.md) (`appmixer.woodpecker.core.ProspectBounced`): Triggers when a message to a prospect bounces.
- [Prospect Interested](https://connectors.appmixer.com/connector/appmixer.woodpecker/1.1.1/component/appmixer.woodpecker.core.ProspectInterested.md) (`appmixer.woodpecker.core.ProspectInterested`): Triggers when a prospect is marked as interested.
- [Prospect Opted Out](https://connectors.appmixer.com/connector/appmixer.woodpecker/1.1.1/component/appmixer.woodpecker.core.ProspectOptedOut.md) (`appmixer.woodpecker.core.ProspectOptedOut`): Triggers when a prospect unsubscribes / opts out.
- [Task Created](https://connectors.appmixer.com/connector/appmixer.woodpecker/1.1.1/component/appmixer.woodpecker.core.TaskCreated.md) (`appmixer.woodpecker.core.TaskCreated`): Triggers when a new manual task is created.

## Actions (17)

- [Add or Update Prospect](https://connectors.appmixer.com/connector/appmixer.woodpecker/1.1.1/component/appmixer.woodpecker.core.AddOrUpdateProspect.md) (`appmixer.woodpecker.core.AddOrUpdateProspect`): Add a new prospect or update an existing one in your Woodpecker account.
- [Add Prospects to Campaign](https://connectors.appmixer.com/connector/appmixer.woodpecker/1.1.1/component/appmixer.woodpecker.core.AddProspectsToCampaign.md) (`appmixer.woodpecker.core.AddProspectsToCampaign`): Add prospects to a campaign in your Woodpecker account.
- [Create Campaign](https://connectors.appmixer.com/connector/appmixer.woodpecker/1.1.1/component/appmixer.woodpecker.core.CreateCampaign.md) (`appmixer.woodpecker.core.CreateCampaign`): Create a new email campaign (one email step; delivery on workdays 8:00-18:00). Requires a connected email account (mailbox) in Woodpecker.
- [Delete Campaign](https://connectors.appmixer.com/connector/appmixer.woodpecker/1.1.1/component/appmixer.woodpecker.core.DeleteCampaign.md) (`appmixer.woodpecker.core.DeleteCampaign`): Delete a campaign by its ID.
- [Delete Prospect](https://connectors.appmixer.com/connector/appmixer.woodpecker/1.1.1/component/appmixer.woodpecker.core.DeleteProspect.md) (`appmixer.woodpecker.core.DeleteProspect`): Delete a prospect from your Woodpecker account.
- [Find Prospects](https://connectors.appmixer.com/connector/appmixer.woodpecker/1.1.1/component/appmixer.woodpecker.core.FindProspects.md) (`appmixer.woodpecker.core.FindProspects`): Search prospects in your Woodpecker account by email address.
- [Get Campaign](https://connectors.appmixer.com/connector/appmixer.woodpecker/1.1.1/component/appmixer.woodpecker.core.GetCampaign.md) (`appmixer.woodpecker.core.GetCampaign`): Retrieve a single campaign by its ID.
- [Get Campaign Statistics](https://connectors.appmixer.com/connector/appmixer.woodpecker/1.1.1/component/appmixer.woodpecker.core.GetCampaignStatistics.md) (`appmixer.woodpecker.core.GetCampaignStatistics`): Retrieve statistics for a single campaign by its ID.
- [Get Mailbox](https://connectors.appmixer.com/connector/appmixer.woodpecker/1.1.1/component/appmixer.woodpecker.core.GetMailbox.md) (`appmixer.woodpecker.core.GetMailbox`): Get a single mailbox from your Woodpecker account by ID.
- [List Manual Tasks](https://connectors.appmixer.com/connector/appmixer.woodpecker/1.1.1/component/appmixer.woodpecker.core.ListManualTasks.md) (`appmixer.woodpecker.core.ListManualTasks`): List all manual tasks in your Woodpecker account.
- [List Prospects](https://connectors.appmixer.com/connector/appmixer.woodpecker/1.1.1/component/appmixer.woodpecker.core.ListProspects.md) (`appmixer.woodpecker.core.ListProspects`): List all prospects in your Woodpecker account.
- [Make Api Call](https://connectors.appmixer.com/connector/appmixer.woodpecker/1.1.1/component/appmixer.woodpecker.core.MakeApiCall.md) (`appmixer.woodpecker.core.MakeApiCall`): Performs an arbitrary authorized API call to the Woodpecker API.
- [Pause Campaign](https://connectors.appmixer.com/connector/appmixer.woodpecker/1.1.1/component/appmixer.woodpecker.core.PauseCampaign.md) (`appmixer.woodpecker.core.PauseCampaign`): Pause a running campaign by its ID.
- [Run Campaign](https://connectors.appmixer.com/connector/appmixer.woodpecker/1.1.1/component/appmixer.woodpecker.core.RunCampaign.md) (`appmixer.woodpecker.core.RunCampaign`): Start running a campaign by its ID.
- [Stop Campaign](https://connectors.appmixer.com/connector/appmixer.woodpecker/1.1.1/component/appmixer.woodpecker.core.StopCampaign.md) (`appmixer.woodpecker.core.StopCampaign`): Permanently stop a campaign by its ID. This action is permanent and cannot be undone.
- [List Mailboxes](https://connectors.appmixer.com/connector/appmixer.woodpecker/1.1.1/component/appmixer.woodpecker.core.ListMailboxes.md) (`appmixer.woodpecker.core.ListMailboxes`): List all mailboxes in your Woodpecker account.
- [List Campaigns](https://connectors.appmixer.com/connector/appmixer.woodpecker/1.1.1/component/appmixer.woodpecker.core.ListCampaigns.md) (`appmixer.woodpecker.core.ListCampaigns`): List all campaigns in your Woodpecker account. Returns up to the maximum page size (50 campaigns) per call.

## Changelog

### 1.1.2

- Quote CSV cells that hold a comma, a double quote or a line break and map cells by header column when exporting results to a file.

### 1.1.1

- MakeApiCall: Request Headers and Query Parameters set in the Designer are now sent. They were silently dropped: the key-value field stores its rows as a JSON object string, which the component did not parse.

### 1.1.0

- Fixed API endpoints: Add Or Update Prospect now calls POST /v1/add_prospects_list (POST /v1/prospects does not exist), List Campaigns calls GET /v1/campaign_list (GET /v2/campaigns responds 405; empty accounts respond 204) and List Manual Tasks calls /v2/manual_tasks (underscore).
- Create Campaign now sends the full APIv2 campaign structure (settings with timezone and daily_enroll, email_account_ids, START→EMAIL steps with delivery times and a body version). New required inputs: Email Account ID (a connected Woodpecker mailbox), Subject and Message; new optional Daily Enroll Limit; the unsupported From Name input was removed.
- Find Prospects now searches via GET /v2/prospects (the previously used /v1/search-prospects endpoint responds 400).
- Get Campaign Statistics reads stats from the v1 campaign detail (GET /v1/campaign_list?id=X) — the previously used /v2/campaigns/:id/statistics endpoint does not exist; output now carries the real stats fields (prospects, sent, delivery, opened, clicked, replied, interested, bounced, invalid, optout, queue).
- List Mailboxes and Get Mailbox flatten the API's nested `details` object so the declared output fields (email, from_name, daily_limit, ...) resolve.
- Added MakeApiCall component for performing arbitrary authorized API calls to the Woodpecker API.
- Copilot review round: awaited lock release and PII-safe payload logging (opt-in via logWebhookPayloads config) in the plugin webhook route, events without a company id are skipped instead of routed to an 'unknown' listener key, plugin triggers fail fast when the account has no company id, Add Prospects To Campaign requires and validates the prospects array, Task Created Flow Test prefers a real manual task id, company_id output accepts string ids.

### 1.0.0

- Initial release. Campaigns and Prospects actions, Mailboxes, Manual Tasks and webhook-based triggers.
