[Cotlet](https://cotlet.dev/index.md) · [Integrations](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Use cases](https://cotlet.dev/use-cases.md) · [Security](https://cotlet.dev/security.md) · [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md) · [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [Contact](https://cotlet.dev/contact.md) · [Pricing](https://cotlet.dev/pricing.md) · [Sign up](https://cotlet.dev/signup)

# Create a task

> Create a task related to a record, with priority and due date. Inputs, cURL, Python and Node.js examples and an example response.

Source: https://cotlet.dev/docs/api/suitecrm/create_task

Docs sections: [Get started](https://cotlet.dev/docs.md) · [REST API](https://cotlet.dev/docs/api.md) · [MCP](https://cotlet.dev/docs/mcp.md) · [SDKs & CLI](https://cotlet.dev/docs/sdks.md) · [Integrations](https://cotlet.dev/docs/integrations.md)

Create a task related to a record, with priority and due date.

SuiteCRM API: https://cotlet.dev/docs/api/suitecrm.md

`POST https://cotlet.dev/api/v1/suitecrm/tasks`

Access: write.

Creates the task assigned to your user, shown in the Activities tile of the record it relates to. It reaches no one else and is undone in one call with close_task, so it does not wait for your OK.

## Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `subject` | string | yes | Name of the task. |
| `status` | string | no | One of: Not Started, In Progress, Completed, Pending Input, Deferred. |
| `priority` | string | no | One of: High, Medium, Low. |
| `due_date` | string | no | ISO date. |
| `related_to_module` | string | no | Module of the record it belongs to: Accounts, Contacts, Leads, Opportunities or Cases. |
| `related_to_id` | string | no | Record ID of the record it belongs to. |

## Request

**cURL**

```bash
curl -X POST https://cotlet.dev/api/v1/suitecrm/tasks \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"subject":"Send revised quote to Northwind Dental","status":"Not Started","priority":"High","due_date":"2026-10-28","related_to_module":"Opportunities","related_to_id":"8f2a41c7-6d3e-90b5-17ac-4e5d0b9a2c61"}'
```

**Python**

```python
result = client.call("suitecrm", "create_task", {"subject":"Send revised quote to Northwind Dental","status":"Not Started","priority":"High","due_date":"2026-10-28","related_to_module":"Opportunities","related_to_id":"8f2a41c7-6d3e-90b5-17ac-4e5d0b9a2c61"})
```

**Node.js**

```js
const result = await cotlet.call('suitecrm', 'create_task', {"subject":"Send revised quote to Northwind Dental","status":"Not Started","priority":"High","due_date":"2026-10-28","related_to_module":"Opportunities","related_to_id":"8f2a41c7-6d3e-90b5-17ac-4e5d0b9a2c61"});
```

**CLI**

```bash
cotlet call suitecrm create_task --data '{"subject":"Send revised quote to Northwind Dental","status":"Not Started","priority":"High","due_date":"2026-10-28","related_to_module":"Opportunities","related_to_id":"8f2a41c7-6d3e-90b5-17ac-4e5d0b9a2c61"}'
```

## Example response

```json
{
  "task_id": "b6f3a290-1d84-4c7e-8e5a-2f9d0c71a4b3",
  "subject": "Send revised quote to Northwind Dental",
  "status": "Not Started",
  "priority": "High",
  "due_date": "2026-10-28",
  "related_to": {
    "module": "Opportunities",
    "id": "8f2a41c7-6d3e-90b5-17ac-4e5d0b9a2c61",
    "name": "Northwind Dental: onboarding"
  }
}
```

Previous: [Convert a lead](https://cotlet.dev/docs/api/suitecrm/convert_lead.md)
Next: [Close a task](https://cotlet.dev/docs/api/suitecrm/close_task.md)

---

Give your AI agents your signed-in browser.

**Product:** [Integrations](https://cotlet.dev/integrations.md) · [Use cases](https://cotlet.dev/use-cases.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Pricing](https://cotlet.dev/pricing.md) · [Security](https://cotlet.dev/security.md)

**Resources:** [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [GitHub](https://github.com/cotletdev/cotlet)

**Solutions:** [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md)

**Company:** [About](https://cotlet.dev/about.md) · [AI info: company facts](https://cotlet.dev/ai-info.md) · [Contact](https://cotlet.dev/contact.md)

**Legal:** [Terms of service](https://cotlet.dev/terms) · [Privacy policy](https://cotlet.dev/privacy) · [Refund policy](https://cotlet.dev/refunds) · [Acceptable use](https://cotlet.dev/acceptable-use) · [Cookie policy](https://cotlet.dev/cookies) · [DPA](https://cotlet.dev/dpa) · [Subprocessors](https://cotlet.dev/subprocessors)

**Elsewhere:** [Status page](https://status.cotlet.dev) · [Cotlet on GitHub](https://github.com/cotletdev) · [Cotlet on X](https://x.com/cotletdev) · [Cotlet on LinkedIn](https://www.linkedin.com/company/cotletdev) · [Cotlet on Product Hunt](https://www.producthunt.com/products/cotlet) · [Cotlet on Crunchbase](https://www.crunchbase.com/organization/cotlet) · [Cotlet on SaaSHub](https://www.saashub.com/cotlet)

Cotlet.dev is built by Bart Krawczyk and Jake Slugocki, the founders of Take Group sp. z o.o., ul. Wincentego Janasa 4, 40-855 Katowice, Poland. KRS 0000871398, NIP 6342984273, VAT EU: PL6342984273. [About us](https://cotlet.dev/about.md)

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.