Create a follow-up task
Give a lead a next step. Set a due date, optional company and an assignee in your workspace.
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.
/tasksAuthorization
bearerAuth 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.