This section as Markdown: View Download

Lemlist Integration

Connect your agent to Lemlist for cold email outreach and campaign orchestration.

Overview

The Lemlist integration uses HTTP Basic Authentication with an empty username and the API key as the password.

Skills that use this integration:

int-lemlist-outreach — Campaign creation, lead uploads, pause/resume

Agents that typically enable this integration:

Lead Generation Manager

Availability

Mode	Status	Notes
API Key	Available	Lemlist API key (Gold tier or higher).

Prerequisites

A Wiro API key — Authentication.
A deployed agent — Agent Overview.
A Lemlist account on Gold tier or higher for full API access.

Setup

Step 1: Get an API key

app.lemlist.com → Settings → Integrations → API.
Click Generate (or copy existing). Keys look like AbCdEfGhIjKlMnOp.

Step 2: Save to Wiro

curl -X POST "https://api.wiro.ai/v1/UserAgent/CredentialUpsert" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "useragentguid": "your-useragent-guid",
    "fields": [
      { "credentialkey": "lemlist", "fieldname": "apikey", "fieldvalue": "YOUR_LEMLIST_API_KEY" }
    ]
  }'

Step 3: Start the agent

curl -X POST "https://api.wiro.ai/v1/UserAgent/Start" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{ "guid": "your-useragent-guid" }'

Credential Fields

Field	Type	Description
`apikey`	string	Lemlist API key.

Credentials schema (as returned by `POST /UserAgent/Detail`)

"lemlist": {
  "_connected": false,
  "optional": true,
  "extra": false,
  "apikey": ""
}

Runtime Behavior

The int-lemlist-outreach skill is active only when it is enabled and apikey is set.

Auth: Basic auth with an empty username and the API key as the password, as Lemlist documents.
Base URL: https://api.lemlist.com/api.

Rate limits: ~20 requests per 2 seconds; 429 requires backoff.

Troubleshooting

401 Unauthorized: API key revoked in Lemlist settings. Regenerate.
403 on campaign operations: Plan tier lacks API write access. Upgrade.
Email address not found: Lead must exist in at least one campaign before some endpoints work — upload leads first.