---
updatedAt: 2025-09-14T10:19:46.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 Goals
Creates multiple goals in a single request using the `items` array.
Each goal will be created with the specified owner and properties.
**Limitations:**
- You can create up to 25 goals per request.
- If the request includes more than 25 goals, the operation will fail and return an error.
The response includes an array of the created Goal IDs.
If any key result fails to be created, a structured error response will be returned with details for each failed item.
**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.
To learn more about the goal and goal type fields, see [Explore Goals API](https://apidocs.hibob.com/docs/explore-goals-api).
# OpenAPI definition
```json
{
"openapi": "3.1.1",
"info": {
"title": "Goals API",
"description": "Public API for managing Goal Types, Goals, and Key Results with clean entity separation.",
"license": {
"name": "Proprietary",
"url": "https://apidocs.hibob.com/docs/api-terms-of-use"
},
"contact": {
"name": "Hi Bob, Inc."
},
"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": "Goals",
"description": "Operations for managing Goal Types, Goals, and Key Results"
}
],
"paths": {
"/goals/goals": {
"post": {
"operationId": "post_goals-goals",
"tags": [
"Goals"
],
"summary": "Create Goals",
"description": "Creates multiple goals in a single request using the `items` array.
Each goal will be created with the specified owner and properties.
\n**Limitations:**
- You can create up to 25 goals per request.
- If the request includes more than 25 goals, the operation will fail and return an error.
\nThe response includes an array of the created Goal IDs.
If any key result fails to be created, a structured error response will be returned with details for each failed item.\n
\n**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.
\n",
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CreateGoalsRequest"
},
"example": {
"items": [
{
"objectType": "goal",
"fields": {
"title": {
"value": "Complete Project Alpha"
},
"description": {
"value": "Deliver the alpha project on time"
},
"startDate": {
"value": "2025-01-01"
},
"dueDate": {
"value": "2025-06-30"
},
"typeId": {
"value": 1
},
"typeListItem": {
"value": "Engineering"
},
"owner": {
"value": "109876543210"
},
"isPrivate": {
"value": false
},
"alignedGoal": {
"value": 1134
},
"cycleId": {
"value": 456
}
}
}
]
}
}
}
},
"responses": {
"201": {
"description": "Goals created successfully",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"goalIds": {
"type": "array",
"items": {
"type": "integer",
"format": "int64"
},
"description": "Array of created goal IDs"
}
}
},
"example": {
"goalIds": [
100,
101,
102
]
}
}
}
},
"400": {
"description": "Bad request with structured error response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ApiErrorResponse"
}
}
}
},
"429": {
"description": "Rate limit exceeded",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ApiErrorResponse"
}
}
}
},
"500": {
"description": "Internal server error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ApiErrorResponse"
}
}
}
}
},
"security": [
{
"Basic": []
},
{
"Bearer": []
}
]
}
}
},
"components": {
"schemas": {
"ApiErrorResponse": {
"type": "object",
"required": [
"error",
"message",
"statusCode",
"timestamp"
],
"properties": {
"error": {
"type": "string",
"description": "Error type identifier",
"enum": [
"BAD_REQUEST",
"NOT_FOUND",
"INTERNAL_SERVER_ERROR",
"TOO_MANY_REQUESTS",
"UNAUTHORIZED",
"FORBIDDEN"
],
"example": "BAD_REQUEST"
},
"message": {
"type": "string",
"description": "Human-readable error message",
"example": "Invalid input provided"
},
"statusCode": {
"type": "integer",
"description": "HTTP status code",
"enum": [
400,
401,
403,
404,
429,
500
],
"example": 400
},
"timestamp": {
"type": "string",
"format": "date-time",
"description": "ISO timestamp when the error occurred",
"example": "2025-01-01T12:00:00Z"
}
}
},
"CreateGoalsRequest": {
"type": "object",
"description": "Request schema for creating new goals",
"properties": {
"items": {
"type": "array",
"maxItems": 25,
"description": "List of goals to create",
"items": {
"type": "object",
"properties": {
"objectType": {
"type": "string",
"description": "Type of the object",
"enum": [
"goal"
],
"default": "goal"
},
"fields": {
"type": "object",
"properties": {
"title": {
"type": "object",
"description": "The title of the goal",
"properties": {
"value": {
"type": "string"
}
},
"required": [
"value"
]
},
"description": {
"type": "object",
"description": "A brief description of the goal",
"properties": {
"value": {
"type": "string"
}
}
},
"startDate": {
"type": "object",
"description": "The start date of the goal",
"properties": {
"value": {
"type": "string",
"format": "date"
}
},
"required": [
"value"
]
},
"dueDate": {
"type": "object",
"description": "The due date of the goal",
"properties": {
"value": {
"type": "string",
"format": "date"
}
},
"required": [
"value"
]
},
"typeId": {
"type": "object",
"description": "The type ID of the goal",
"properties": {
"value": {
"type": "integer",
"format": "int64"
}
},
"required": [
"value"
]
},
"typeListItem": {
"type": "object",
"description": "The type list item of the goal",
"properties": {
"value": {
"type": "string"
}
}
},
"owner": {
"type": "object",
"description": "The owner of the goal. Must be an existing owner identifier\n",
"properties": {
"value": {
"type": "string"
}
},
"required": [
"value"
]
},
"isPrivate": {
"type": "object",
"description": "Whether the goal is private",
"properties": {
"value": {
"type": "boolean"
}
},
"required": [
"value"
]
},
"alignedGoal": {
"type": "object",
"description": "The ID of the goal this goal is aligned to (if any)",
"properties": {
"value": {
"type": "integer",
"format": "int64"
}
}
},
"cycleId": {
"type": "object",
"description": "The ID of the cycle to assign this goal to (optional). When a cycle is assigned, the goal’s weight within that cycle is automatically and equally distributed across all goals in the employee’s cycle.\n",
"properties": {
"value": {
"type": "integer",
"format": "int64"
}
}
}
},
"required": [
"title",
"startDate",
"dueDate",
"typeId",
"owner",
"isPrivate"
]
}
},
"required": [
"objectType",
"fields"
]
}
}
},
"required": [
"items"
]
}
},
"securitySchemes": {
"Basic": {
"type": "http",
"scheme": "basic"
},
"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."
}
}
}
}
```