aventra.Developers
API referenceTasks

Create a follow-up task

Create a follow-up task in Aventra CRM with an assignee from your workspace. Set a due date and optionally link the task to a company.

Permissions: Tasks: read and write.

Behavior and retry rules

user_id is required. Use GET users to find the assignee by email. Supply a stable id for timeout recovery. A repeated ID returns 409; GET the task to check the result. Set has_time_specified: false for a date-only task; still provide a timestamp representing the intended date in your team's timezone.

POST/tasks

Authorization

bearerAuth
AuthorizationBearer <token>

Create a key in Aventra → Innstillinger → API-nøkler.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/tasks" \  -H "Authorization: Bearer $AVENTRA_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "user_id": "f52b3fd3-5ff4-4d93-91c5-6ac79e21cdd5",    "title": "Follow up on demo request",    "due_date": "2026-10-05T09:00:00+02:00",    "related_company_id": "4d73dca4-7537-4f9c-924e-8bccd354663f"  }'
{  "data": {    "id": "ea2fb66b-6c76-419f-a3e7-a9f8a2d6f47c",    "title": "Follow up on demo request",    "description": null,    "due_date": "2026-10-05T07:00:00Z",    "has_time_specified": true,    "user_id": "f52b3fd3-5ff4-4d93-91c5-6ac79e21cdd5",    "related_company_id": "4d73dca4-7537-4f9c-924e-8bccd354663f",    "completed": false,    "created_at": "2026-09-05T10:00:00Z",    "updated_at": "2026-09-05T10:00:00"  }}

See authentication, errors and retry guidance.

Get company links

Read the company relationships of an Aventra CRM contact by its UUID. Results include linked company IDs and roles, ordered by relationship ID.

Update or complete a task

Update an Aventra CRM task or mark it complete using its UUID. Change the assignee, due date or company link while preserving omitted fields.