Skip to main content
POST
/
tasks
Create Task
curl --request POST \
  --url https://api.lemlist.com/api/tasks \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '{
  "type": "phone",
  "assignedTo": "usr_6Y58qbtsYv2rCHQiJ",
  "dueDate": "2025-02-10T09:58:57.169Z",
  "message": "this is my message",
  "title": "this is my title",
  "leadId": "lea_QerTQT4gtxsXpLHK3"
}'
{
  "_id": "opp_ouYzdLYGs4RcrHTfm",
  "type": "manual",
  "title": "Keep an eye on him",
  "priority": 1,
  "leadId": "lea_mizMsAEkRrJuhouYe",
  "campaignId": "cam_9NsHPnykWESTncCW8",
  "contactId": "ctc_Rofmb6uNGyaPNZ2ni",
  "dueDate": "2025-11-10T09:58:57.169Z",
  "userId": "usr_gmHgNGRcGPSTJrDbT",
  "content": "does he have bandwidth to help us? would be grand"
}
This endpoint uses the Task object.
Create a manual task (opportunity) associated with a contact/company or lead. The task must be assigned to a team member and have a due date. Optional fields let you set a title, message, and priority.

Authorizations

​
Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Body

application/json
​
type
enum<string>
required

The type of task.

Available options:
email,
manual,
phone,
linkedin
​
assignedTo
string
required

The ID of the team member assigned to the task (userId).

​
dueDate
string<date-time>
required

The due date in ISO 8601 format (e.g., 2025-02-12T00:00:00.000Z).

​
recordId
string

The ID of the contact company or lead associated with the task.

​
title
string
default:""

Optional title of the task. Defaults to an empty string if omitted.

​
message
string
default:""

Optional message/description of the task. Defaults to an empty string if omitted.

​
priority
enum<string>
default:""

Priority level of the task.

Available options:
,
0,
1,
2

Response

Success

A manual action assigned to a user to complete.

​
_id
string

Unique task identifier

​
type
string

Task type

​
leadId
string

Associated lead ID

​
campaignId
string

Campaign ID

​
userId
string

Assigned user ID

​
status
enum<string>

Task status

Available options:
pending,
completed,
ignored
​
dueDate
string<date-time>

Due date timestamp

​
createdAt
string<date-time>

Creation timestamp

​
completedAt
string<date-time>

Completion timestamp