---
updatedAt: 2025-12-23T14:31:24.000Z
---
Fetch the complete documentation index at: https://apidocs.hibob.com/llms.txt. Use this file to discover all available pages before exploring further.
# Create Project Task(s)
Create one or more project tasks with the specified fields. Supports bulk creation of up to 100 tasks in a single request.
Note: Tasks are created as `active` by default. To update the status, use archive/restore endpoints
Testing notes:
- Use the testing widget's Try It! option to test this endpoint.
- Use the Examples > Request Example option to see how to initiate body parameters.
# OpenAPI definition
```json
{
"openapi": "3.1.1",
"info": {
"title": "Attendance API",
"contact": {
"name": "Hi Bob, Inc."
},
"description": "Public API for importing attendance entries and managing attendance projects, tasks, and clients. Supports detailed field metadata and flexible filtering.",
"license": {
"name": "Proprietary",
"url": "https://apidocs.hibob.com/docs/api-terms-of-use"
},
"version": "1.0.0"
},
"servers": [
{
"url": "https://api.hibob.com/v1",
"description": "Production"
},
{
"url": "https://api.sandbox.hibob.com/v1",
"description": "Sandbox"
}
],
"x-readme": {
"metrics-enabled": false
},
"tags": [
{
"name": "Projects",
"description": "Operations for managing attendance projects, tasks and clients"
}
],
"paths": {
"/attendance/project-tasks": {
"post": {
"operationId": "post_attendance-project-tasks",
"tags": [
"Projects"
],
"summary": "Create Project Task(s)",
"description": "Create one or more project tasks with the specified fields. Supports bulk creation of up to 100 tasks in a single request.\n\nNote: Tasks are created as `active` by default. To update the status, use archive/restore endpoints
\n\nTesting notes:
\n \n - Use the testing widget's Try It! option to test this endpoint.
\n - Use the Examples > Request Example option to see how to initiate body parameters.
\n
\n",
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/TaskCreateRequest"
},
"examples": {
"basicTaskCreate": {
"summary": "Create a billable task",
"value": {
"items": [
{
"objectType": "projectTask",
"fields": {
"/projectTask/name": {
"value": "Frontend Development"
},
"/projectTask/billable": {
"value": true
}
}
}
]
}
}
}
}
}
},
"responses": {
"201": {
"description": "Task created successfully",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/TaskCreateResponse"
},
"examples": {
"singleTask": {
"summary": "Single task created",
"description": "Response when creating a single task",
"value": {
"ids": [
123
]
}
},
"multipleTasks": {
"summary": "Multiple tasks created",
"description": "Response when creating multiple tasks in bulk",
"value": {
"ids": [
123,
456
]
}
}
}
}
}
},
"400": {
"description": "The request is malformed or includes invalid parameters",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ApiErrorResponse"
}
}
}
},
"401": {
"description": "Authentication failed. Check your service user credentials",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ApiErrorResponse"
}
}
}
},
"403": {
"description": "The service user or token is missing the required permissions to access the requested data",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ApiErrorResponse"
}
}
}
},
"429": {
"description": "Rate limit exceeded - see Rate limits",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ApiErrorResponse"
}
}
}
},
"500": {
"description": "An unexpected error occurred. Try again or contact support if the issue persists.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ApiErrorResponse"
}
}
}
}
},
"security": [
{
"basic": []
},
{
"Bearer": []
}
]
}
}
},
"components": {
"securitySchemes": {
"basic": {
"type": "http",
"scheme": "basic",
"description": "Basic HTTP authentication using service user credentials"
},
"Bearer": {
"type": "http",
"scheme": "bearer",
"bearerFormat": "OAuth 2.0",
"description": "OAuth 2.0 authentication using an Access Token is available for registered partners only. Try It! does not support the full HiBob OAuth flow. You can follow these steps to complete the OAuth 2.0 flow in Postman and then paste the token here."
}
},
"schemas": {
"ApiErrorResponse": {
"type": "object",
"properties": {
"key": {
"type": "string",
"description": "Error key identifier"
},
"error": {
"type": "string",
"description": "Human-readable error message"
},
"args": {
"type": "array",
"description": "Optional error arguments providing additional context",
"items": {
"type": "string"
}
}
}
},
"TaskCreateRequestObject": {
"type": "object",
"properties": {
"objectType": {
"type": "string",
"enum": [
"projectTask"
],
"description": "Type of the object"
},
"fields": {
"type": "object",
"properties": {
"/projectTask/name": {
"type": "object",
"description": "The task name (required)",
"properties": {
"value": {
"type": "string"
}
}
},
"/projectTask/billable": {
"type": "object",
"description": "Whether this task is billable (required)",
"properties": {
"value": {
"type": "boolean"
}
}
}
},
"required": [
"/projectTask/name",
"/projectTask/billable"
],
"description": "Task fields for create request"
}
},
"required": [
"objectType",
"fields"
]
},
"TaskCreateResponse": {
"type": "object",
"properties": {
"ids": {
"type": "array",
"items": {
"type": "integer",
"format": "int64"
},
"description": "Array of unique identifiers of the created tasks"
}
}
},
"TaskCreateRequest": {
"type": "object",
"description": "Request schema for creating project tasks",
"properties": {
"items": {
"type": "array",
"description": "List of tasks to create (1-100 items)",
"minItems": 1,
"maxItems": 100,
"items": {
"$ref": "#/components/schemas/TaskCreateRequestObject"
}
}
},
"required": [
"items"
]
}
}
}
}
```