GuidesAPI ReferenceChangelog
API Reference

Creates a Task

post
https://api.factorialhr.com/api/2026-10-01/resources/tasks/tasks

This endpoint creates a new task. Use author_employee_id to set who authors the task, otherwise the first active employee of the company is used.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

name of the task.

string

description of the task

string

expiration date of the task.

assignee_ids
array of strings

Employees assigned to the task, assignee_id references to access_id.

assignee_ids
string

employee that will be set as the author of the task. Only taken into account when authenticating with an API key, requests performed on behalf of a user always use that user as the author. When omitted, the task is authored by the first active employee of the company.

string
enum
required

status of the task (todo | in_progress | done | discarded).

Allowed:
Response

Updated about 2 months ago

Did this page help you?
Language
Credentials
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 2 months ago

Did this page help you?