lemlist

lemlist Tasks API

Manual tasks - list, create, update and ignore.

Documentation GitHub OpenAPI

Operations 4

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /tasks List my tasks · Tasks #

Ask an LLM

“What manual tasks are waiting for me in lemlist?”

“Which to-dos, like calls or LinkedIn steps, are on my list?”

Tell an agent

List my tasks.

Show the manual tasks I still have to do.

POST /tasks Create a task for a lead · Tasks #

Ask an LLM

“How do I create a follow-up task tied to a specific lead?”

“Can I add a to-do for a lead from outside lemlist?”

Tell an agent

Create a task for lead {leadId}.

Add a follow-up to-do on lead {leadId}.

PATCH /tasks Update existing tasks · Tasks #

Ask an LLM

“Can I mark a task as done or change its due date?”

“How do I edit tasks that are already created?”

Tell an agent

Update my existing tasks.

Mark these tasks as completed.

POST /tasks/ignore Ignore tasks · Ignore tasks #

Ask an LLM

“Is there a way to skip tasks I don't intend to do?”

“How do I dismiss tasks from my queue without completing them?”

Tell an agent

Ignore these tasks.

Dismiss the selected tasks from my queue.

Specifications

⚙

OpenAPI

https://raw.githubusercontent.com/api-evangelist/lemlist/refs/heads/main/openapi/lemlist-tasks-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/lemlist:lemlist-tasks-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Lemlist Tasks API
  version: 1.0.0
  description: 'Operations tagged Tasks across 2 of this provider''s published API definitions: lemlist-openapi-v1-legacy.json, lemlist-openapi-v2.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.lemlist.com/api
tags:
- name: Tasks
paths:
  /tasks:
    parameters: []
    get:
      summary: Tasks
      tags:
      - Tasks
      parameters: []
      responses:
        default:
          headers:
            Content-Type:
              schema:
                type: string
              example: application/json
          description: Tasks
          content:
            application/json:
              schema:
                type: object
                properties:
                  results:
                    type: array
                    items:
                      type: object
                      properties:
                        _id:
                          type: string
                        type:
                          type: string
                        leadId:
                          type: string
                        campaignId:
                          type: string
                        contactId:
                          type: string
                        dueDate:
                          type: string
                          format: date-time
                        userId:
                          type: string
                  page:
                    type: integer
              example:
                results:
                - _id: opp_vDuwoqRopZ4ygeApq
                  type: phone
                  leadId: lea_4ZnGoytR5uoZs7Bod
                  campaignId: cam_fX7SwMGyooxFLeeiM
                  contactId: ctc_iSW6pi7AFnufvhgeS
                  dueDate: '2025-02-13T10:02:35.209Z'
                  userId: usr_6Y58qbtsYv2rCHQiJ
                - _id: opp_22vSBY7pNKskQ9XDX
                  type: phone
                  leadId: lea_4QqkLsi3gDawLsRLP
                  campaignId: cam_fX7SwMGyooxFLeeiM
                  contactId: ctc_Ak6dK4XGT73kgYoHe
                  dueDate: '2025-02-13T10:02:35.208Z'
                  userId: usr_6Y58qbtsYv2rCHQiJ
                - _id: opp_wa9CizcCzWMyWQMab
                  type: phone
                  leadId: lea_T478Y3PBtunxLA3uD
                  campaignId: cam_ZoNvbA4nnE9T3T3Xp
                  contactId: ctc_Bpy8KPvJuCkGGbYJ2
                  dueDate: '2025-02-13T09:08:53.061Z'
                  userId: usr_6Y58qbtsYv2rCHQiJ
                - _id: opp_qJFeKB4pdofKAiTpS
                  type: phone
                  leadId: lea_fZKPKs29MwsZwruj8
                  campaignId: cam_ZoNvbA4nnE9T3T3Xp
                  contactId: ctc_8dKYwwv2pGmupjamP
                  dueDate: '2025-02-13T09:08:53.061Z'
                  userId: usr_6Y58qbtsYv2rCHQiJ
                page: 0
      operationId: getTasks
      x-operation-id-source: derived
    post:
      summary: Tasks
      tags:
      - Tasks
      parameters: []
      responses:
        default:
          headers: {}
          description: Tasks
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                leadId:
                  type: string
            example:
              leadId: lea_sMsXBnXd7mG2XdxFR
      operationId: postTasks
      x-operation-id-source: derived
    patch:
      summary: Tasks
      tags:
      - Tasks
      parameters: []
      responses:
        default:
          headers: {}
          description: Opportunities
      operationId: patchTasks
      x-operation-id-source: derived
    servers:
    - url: https://api.lemlist.com/api
  /tasks/ignore:
    parameters: []
    post:
      summary: Ignore tasks
      tags:
      - Tasks
      parameters: []
      responses:
        default:
          headers: {}
          description: Ignore tasks
      operationId: postTasksIgnore
      x-operation-id-source: derived
    servers:
    - url: https://api.lemlist.com/api
components:
  schemas:
    Task:
      type: object
      description: A manual action assigned to a user to complete.
      properties:
        _id:
          type: string
          description: Unique task identifier
        type:
          type: string
          description: Task type
        leadId:
          type: string
          description: Associated lead ID
        campaignId:
          type: string
          description: Campaign ID
        userId:
          type: string
          description: Assigned user ID
        status:
          type: string
          description: Task status
          enum:
          - pending
          - completed
          - ignored
        dueDate:
          type: string
          format: date-time
          description: Due date timestamp
        createdAt:
          type: string
          format: date-time
          description: Creation timestamp
        completedAt:
          type: string
          format: date-time
          description: Completion timestamp
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
x-refined-from:
- lemlist-openapi-v1-legacy.json
- lemlist-openapi-v2.json