# Send Lemlist to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "lemlist", "name": "Lemlist", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/byungkyu/lemlist", "canonicalUrl": "https://clawhub.ai/byungkyu/lemlist", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/lemlist", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=lemlist", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md", "LICENSE.txt" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "lemlist", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-04T22:13:52.406Z", "expiresAt": "2026-05-11T22:13:52.406Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=lemlist", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=lemlist", "contentDisposition": "attachment; filename=\"lemlist-1.0.1.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "lemlist" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/lemlist" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/lemlist", "downloadUrl": "https://openagent3.xyz/downloads/lemlist", "agentUrl": "https://openagent3.xyz/skills/lemlist/agent", "manifestUrl": "https://openagent3.xyz/skills/lemlist/agent.json", "briefUrl": "https://openagent3.xyz/skills/lemlist/agent.md" } } ``` ## Documentation ### Lemlist Access the Lemlist API with managed OAuth authentication. Manage campaigns, leads, activities, schedules, sequences, and unsubscribes for sales automation and cold outreach. ### Quick Start # List campaigns python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://gateway.maton.ai/lemlist/api/campaigns') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF ### Base URL https://gateway.maton.ai/lemlist/api/{resource} Replace {resource} with the actual Lemlist API endpoint path. The gateway proxies requests to api.lemlist.com/api and automatically injects your OAuth token. ### Authentication All requests require the Maton API key in the Authorization header: Authorization: Bearer $MATON_API_KEY Environment Variable: Set your API key as MATON_API_KEY: export MATON_API_KEY="YOUR_API_KEY" ### Getting Your API Key Sign in or create an account at maton.ai Go to maton.ai/settings Copy your API key ### Connection Management Manage your Lemlist OAuth connections at https://ctrl.maton.ai. ### List Connections python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections?app=lemlist&status=ACTIVE') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF ### Create Connection python <<'EOF' import urllib.request, os, json data = json.dumps({'app': 'lemlist'}).encode() req = urllib.request.Request('https://ctrl.maton.ai/connections', data=data, method='POST') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') req.add_header('Content-Type', 'application/json') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF ### Get Connection python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF Response: { "connection": { "connection_id": "3ecf268f-42ad-40cc-b77a-25e020fbf591", "status": "ACTIVE", "creation_time": "2026-02-12T02:00:53.023887Z", "last_updated_time": "2026-02-12T02:01:45.284131Z", "url": "https://connect.maton.ai/?session_token=...", "app": "lemlist", "metadata": {} } } Open the returned url in a browser to complete OAuth authorization. ### Delete Connection python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}', method='DELETE') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF ### Specifying Connection If you have multiple Lemlist connections, specify which one to use with the Maton-Connection header: python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://gateway.maton.ai/lemlist/api/campaigns') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') req.add_header('Maton-Connection', '3ecf268f-42ad-40cc-b77a-25e020fbf591') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF If omitted, the gateway uses the default (oldest) active connection. ### Team Get Team GET /lemlist/api/team Returns team information including user IDs and settings. Get Team Credits GET /lemlist/api/team/credits Returns remaining credits balance. Get Team Senders GET /lemlist/api/team/senders Returns all team members and their associated campaigns. ### Campaigns List Campaigns GET /lemlist/api/campaigns Create Campaign POST /lemlist/api/campaigns Content-Type: application/json { "name": "My Campaign" } Creates a new campaign with an empty sequence and default schedule automatically added. Get Campaign GET /lemlist/api/campaigns/{campaignId} Update Campaign PATCH /lemlist/api/campaigns/{campaignId} Content-Type: application/json { "name": "Updated Campaign Name" } Pause Campaign POST /lemlist/api/campaigns/{campaignId}/pause Pauses a running campaign. ### Campaign Sequences Get Campaign Sequences GET /lemlist/api/campaigns/{campaignId}/sequences Returns all sequences and steps for a campaign. ### Campaign Schedules Get Campaign Schedules GET /lemlist/api/campaigns/{campaignId}/schedules Returns all schedules associated with a campaign. ### Leads Add Lead to Campaign POST /lemlist/api/campaigns/{campaignId}/leads Content-Type: application/json { "email": "lead@example.com", "firstName": "John", "lastName": "Doe", "companyName": "Acme Inc" } Creates a new lead and adds it to the campaign. If the lead already exists, it will be inserted into the campaign. Get Lead by Email GET /lemlist/api/leads/{email} Update Lead in Campaign PATCH /lemlist/api/campaigns/{campaignId}/leads/{email} Content-Type: application/json { "firstName": "Jane", "lastName": "Smith" } Delete Lead from Campaign DELETE /lemlist/api/campaigns/{campaignId}/leads/{email} ### Activities List Activities GET /lemlist/api/activities Returns the history of campaign activities (last 100 activities). Query parameters: campaignId - Filter by campaign type - Filter by activity type (emailsSent, emailsOpened, emailsClicked, etc.) ### Schedules List Schedules GET /lemlist/api/schedules Returns all schedules with pagination. Response: { "schedules": [...], "pagination": { "totalRecords": 10, "currentPage": 1, "nextPage": 2, "totalPage": 2 } } Create Schedule POST /lemlist/api/schedules Content-Type: application/json { "name": "Business Hours", "timezone": "America/New_York", "start": "09:00", "end": "17:00", "weekdays": [1, 2, 3, 4, 5] } Weekdays: 0 = Sunday, 1 = Monday, ..., 6 = Saturday Get Schedule GET /lemlist/api/schedules/{scheduleId} Update Schedule PATCH /lemlist/api/schedules/{scheduleId} Content-Type: application/json { "name": "Updated Schedule", "start": "08:00", "end": "18:00" } Delete Schedule DELETE /lemlist/api/schedules/{scheduleId} ### Companies List Companies GET /lemlist/api/companies Returns companies with pagination. Response: { "data": [...], "total": 100 } ### Unsubscribes List Unsubscribes GET /lemlist/api/unsubscribes Returns all unsubscribed emails and domains. Add Unsubscribe POST /lemlist/api/unsubscribes Content-Type: application/json { "email": "unsubscribe@example.com" } Can also add domains by using a domain value. ### Inbox Labels List Labels GET /lemlist/api/inbox/labels Returns all labels available to the team. ### Pagination Lemlist uses page-based pagination with different formats depending on the endpoint: Schedules format: { "schedules": [...], "pagination": { "totalRecords": 100, "currentPage": 1, "nextPage": 2, "totalPage": 10 } } Companies format: { "data": [...], "total": 100 } ### JavaScript - List Campaigns const response = await fetch( 'https://gateway.maton.ai/lemlist/api/campaigns', { headers: { 'Authorization': \`Bearer ${process.env.MATON_API_KEY}\` } } ); const campaigns = await response.json(); console.log(campaigns); ### Python - List Campaigns import os import requests response = requests.get( 'https://gateway.maton.ai/lemlist/api/campaigns', headers={'Authorization': f'Bearer {os.environ["MATON_API_KEY"]}'} ) campaigns = response.json() for campaign in campaigns: print(f"{campaign['name']}: {campaign['_id']}") ### Python - Create Campaign and Add Lead import os import requests headers = {'Authorization': f'Bearer {os.environ["MATON_API_KEY"]}'} base_url = 'https://gateway.maton.ai/lemlist/api' # Create campaign campaign_response = requests.post( f'{base_url}/campaigns', headers=headers, json={'name': 'Q1 Outreach'} ) campaign = campaign_response.json() print(f"Created campaign: {campaign['_id']}") # Add lead to campaign lead_response = requests.post( f'{base_url}/campaigns/{campaign["_id"]}/leads', headers=headers, json={ 'email': 'prospect@example.com', 'firstName': 'John', 'lastName': 'Doe', 'companyName': 'Acme Corp' } ) lead = lead_response.json() print(f"Added lead: {lead['_id']}") ### Notes Campaign IDs start with cam_ Lead IDs start with lea_ Schedule IDs start with skd_ Sequence IDs start with seq_ Team IDs start with tea_ User IDs start with usr_ Campaigns cannot be deleted via API (only paused) When creating a campaign, an empty sequence and default schedule are automatically added Lead emails are used as identifiers for lead operations IMPORTANT: When using curl commands, use curl -g when URLs contain brackets to disable glob parsing IMPORTANT: When piping curl output to jq, environment variables may not expand correctly. Use Python examples instead. ### Rate Limits OperationLimitAPI calls20 per 2 seconds per API key When rate limited, implement exponential backoff for retries. ### Error Handling StatusMeaning400Bad request or missing Lemlist connection401Invalid or missing Maton API key404Resource not found405Method not allowed422Validation error429Rate limited4xx/5xxPassthrough error from Lemlist API ### Troubleshooting: API Key Issues Check that the MATON_API_KEY environment variable is set: echo $MATON_API_KEY Verify the API key is valid by listing connections: python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF ### Troubleshooting: Invalid App Name Ensure your URL path starts with lemlist. For example: Correct: https://gateway.maton.ai/lemlist/api/campaigns Incorrect: https://gateway.maton.ai/api/campaigns ### Resources Lemlist API Documentation Lemlist API Reference Lemlist Help Center - API Maton Community Maton Support ## Trust - Source: tencent - Verification: Indexed source record - Publisher: byungkyu - Version: 1.0.0 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-05-04T22:13:52.406Z - Expires at: 2026-05-11T22:13:52.406Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/lemlist) - [Send to Agent page](https://openagent3.xyz/skills/lemlist/agent) - [JSON manifest](https://openagent3.xyz/skills/lemlist/agent.json) - [Markdown brief](https://openagent3.xyz/skills/lemlist/agent.md) - [Download page](https://openagent3.xyz/downloads/lemlist)