SyncroAPI Documentation
Back to site
Syncro

Tasks

Task CRUD. A task can be linked to a lead or standalone.

Base URLhttps://app.syncro.chat/api/v1AuthX-API-Key: crm_SUA_CHAVE_AQUI

The Task object

{
  "id": 45,
  "subject": "Enviar proposta",
  "description": "Mandar PDF com valores",
  "type": "email",
  "status": "pending",
  "priority": "high",
  "due_date": "2026-07-01",
  "due_time": "09:00",
  "completed_at": null,
  "lead_id": 123,
  "lead": { "id": 123, "name": "João Silva", "phone": "+5511999887766", "email": "[email protected]" },
  "assigned_to": 12,
  "assigned_user": { "id": 12, "name": "Ana" },
  "notes": null,
  "is_overdue": false,
  "created_at": "2026-06-30T08:00:00Z",
  "updated_at": "2026-06-30T08:00:00Z"
}

Accepted values

  • type: call, email, task, visit, whatsapp, meeting
  • priority: low, medium, high
  • status: pending, completed

List tasks

GET/tasks
Permission: tasks:read

Paginated.

Query parameters

lead_idintegeroptional
Tasks of a lead
assigned_tointegeroptional
Tasks of an assignee
statusstringoptional
pending or completed
typestringoptional
Type (see above)
prioritystringoptional
low, medium, high
due_fromdateoptional
Due date from
due_todateoptional
Due date until
pageintegeroptional
Page (default 1)
per_pageintegeroptional
Items per page (default 50, max 200)
Request
curl "https://app.syncro.chat/api/v1/tasks?status=pending&lead_id=123" \
  -H "X-API-Key: crm_SUA_CHAVE_AQUI"
Response
{
  "success": true,
  "data": [
    {
      "id": 45,
      "subject": "Enviar proposta",
      "type": "email",
      "status": "pending",
      "priority": "high",
      "due_date": "2026-07-01",
      "lead_id": 123
    }
  ],
  "meta": {
    "total": 1,
    "per_page": 50,
    "current_page": 1,
    "last_page": 1,
    "has_more": false
  }
}

Create task

POST/tasks
Permission: tasks:write

Body parameters

subjectstringrequired
Subject
typestringrequired
call, email, task, visit, whatsapp, meeting
due_datedaterequired
Due date (YYYY-MM-DD)
descriptionstringoptional
Description
prioritystringoptional
low, medium, high
due_timestringoptional
Time (HH:MM)
lead_idintegeroptional
Linked lead
assigned_tointegeroptional
Assignee
notesstringoptional
Notes
Request
curl -X POST "https://app.syncro.chat/api/v1/tasks" \
  -H "X-API-Key: crm_SUA_CHAVE_AQUI" \
  -H "Content-Type: application/json" \
  -d '{
    "subject": "Enviar proposta",
    "type": "email",
    "due_date": "2026-07-01",
    "due_time": "09:00",
    "priority": "high",
    "lead_id": 123,
    "assigned_to": 12
  }'
Response
{
  "success": true,
  "task": {
    "id": 45,
    "subject": "Enviar proposta",
    "status": "pending"
  }
}

Fetch task

GET/tasks/45
Permission: tasks:read
Request
curl "https://app.syncro.chat/api/v1/tasks/45" \
  -H "X-API-Key: crm_SUA_CHAVE_AQUI"
Response
{
  "success": true,
  "task": {
    "id": 45,
    "subject": "Enviar proposta",
    "status": "pending"
  }
}

Update task

PUT/tasks/45
Permission: tasks:write

All fields are optional (partial update). Setting status to completed fills completed_at automatically.

Request
curl -X PUT "https://app.syncro.chat/api/v1/tasks/45" \
  -H "X-API-Key: crm_SUA_CHAVE_AQUI" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "completed"
  }'
Response
{
  "success": true,
  "task": {
    "id": 45,
    "status": "completed",
    "completed_at": "2026-06-30T11:30:00Z"
  }
}

Delete task

DELETE/tasks/45
Permission: tasks:write
Request
curl -X DELETE "https://app.syncro.chat/api/v1/tasks/45" \
  -H "X-API-Key: crm_SUA_CHAVE_AQUI"
Response
{
  "success": true
}

Complete / reopen task

PATCH/tasks/45/toggle
Permission: tasks:write

Toggles the status between pending and completed.

Request
curl -X PATCH "https://app.syncro.chat/api/v1/tasks/45/toggle" \
  -H "X-API-Key: crm_SUA_CHAVE_AQUI"
Response
{
  "success": true,
  "task": {
    "id": 45,
    "status": "completed"
  }
}