Create a task

curl --request POST \
  --url https://backend.leadey.ai/v1/tasks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "label": "Send the revised pricing sheet",
  "dueAt": "2026-08-21T09:00:00.000Z",
  "leadId": "lead_8Kq2mXvR",
  "category": "follow_up"
}
'

import requests

url = "https://backend.leadey.ai/v1/tasks"

payload = {
    "label": "Send the revised pricing sheet",
    "dueAt": "2026-08-21T09:00:00.000Z",
    "leadId": "lead_8Kq2mXvR",
    "category": "follow_up"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    label: 'Send the revised pricing sheet',
    dueAt: '2026-08-21T09:00:00.000Z',
    leadId: 'lead_8Kq2mXvR',
    category: 'follow_up'
  })
};

fetch('https://backend.leadey.ai/v1/tasks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": {
    "id": "task_2Vh7cNsP",
    "label": "Send the revised pricing sheet",
    "category": "follow_up",
    "done": false,
    "dueAt": "2026-08-21T09:00:00.000Z",
    "leadId": "lead_8Kq2mXvR",
    "campaignId": "fnl_Q3OutboundUK",
    "assigneeId": "user_2pXn4Rk",
    "assigneeName": "Sam",
    "createdBy": "user_2pXn4Rk",
    "createdAt": "2026-08-03T11:12:00.000Z",
    "updatedAt": "2026-08-03T11:12:00.000Z"
  }
}

{
  "error": {
    "message": "One of email, phone or linkedinUrl is required",
    "details": null
  }
}

{
  "error": {
    "message": "Invalid or revoked API key.",
    "details": null
  }
}

{
  "error": {
    "message": "This API key is read-only. Create a key with write access in Settings → API Keys.",
    "details": null
  }
}

{
  "error": {
    "message": "Lead not found",
    "details": null
  }
}

{
  "error": {
    "message": "Rate limit exceeded. Retry in 42s.",
    "details": null
  }
}