> ## Documentation Index > Fetch the complete documentation index at: https://docs.superoffice.com/llms.txt > Use this file to discover all available pages before exploring further. # Post Task List Item > Create a new TaskListItem list item Calls the Appointment agent service SaveTaskListItem. ## OpenAPI ````yaml /openapi/rest/openapi-v3-List.json post /api/v1/List/Task/Items openapi: 3.0.0 info: version: v1-REST title: SuperOffice REST API v1 description: SuperOffice REST API - List contact: name: SuperOffice DevNet url: https://docs.superoffice.com/en/api/index.html email: sdk@superoffice.com servers: - url: http://localhost:56350 - url: https://localhost:56350 security: [] tags: [] externalDocs: description: >- The SuperOffice DevNet Community has more documentation, examples, and discussion forums. url: https://community.superoffice.com/en/developer/ paths: /api/v1/List/Task/Items: post: tags: - List_Task summary: Post Task List Item description: |- Create a new TaskListItem list item Calls the Appointment agent service SaveTaskListItem. operationId: v1TaskList_PostTaskListItem parameters: - name: Accept-Language in: header description: >- Convert string references and multi-language values into a specified language (iso2) code. required: false schema: type: string - name: SO-Language in: header description: >- Convert string references and multi-language values into a specified language (iso2) code. Overrides Accept-Language value. required: false schema: type: string - name: SO-Culture in: header description: >- Number, date formatting in a specified culture (iso2 language) code. Partially overrides SO-Language/Accept-Language value. Ignored if no Language set. required: false schema: type: string - name: SO-TimeZone in: header description: >- Specify the timezone code that you would like date/time responses converted to. required: false schema: type: string - name: SO-AppToken in: header description: >- The application token that identifies the partner app. Used when calling Online WebAPI from a server. required: false schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/SuperOffice.CRM.Services.TaskListItem' text/json: schema: $ref: '#/components/schemas/SuperOffice.CRM.Services.TaskListItem' application/xml: schema: $ref: '#/components/schemas/SuperOffice.CRM.Services.TaskListItem' text/xml: schema: $ref: '#/components/schemas/SuperOffice.CRM.Services.TaskListItem' application/x-www-form-urlencoded: schema: $ref: '#/components/schemas/SuperOffice.CRM.Services.TaskListItem' application/json-patch+json: schema: $ref: '#/components/schemas/SuperOffice.CRM.Services.TaskListItem' application/merge-patch+json: schema: $ref: '#/components/schemas/SuperOffice.CRM.Services.TaskListItem' description: The TaskListItem to be created. required: true responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/SuperOffice.CRM.Services.TaskListItem' text/json: schema: $ref: '#/components/schemas/SuperOffice.CRM.Services.TaskListItem' application/xml: schema: $ref: '#/components/schemas/SuperOffice.CRM.Services.TaskListItem' text/xml: schema: $ref: '#/components/schemas/SuperOffice.CRM.Services.TaskListItem' application/json-patch+json: schema: $ref: '#/components/schemas/SuperOffice.CRM.Services.TaskListItem' application/merge-patch+json: schema: $ref: '#/components/schemas/SuperOffice.CRM.Services.TaskListItem' security: - SuperOffice_Password: [] SuperId_Authentication: [] components: schemas: SuperOffice.CRM.Services.TaskListItem: description: "Carrier object for TaskListItem.\r\nServices for the TaskListItem Carrier is available from the Appointment Agent." type: object properties: TaskListItemId: format: int32 description: Primary key type: integer Value: description: The list item type: string Direction: description: 1 = incoming, 2 = outgoing, see EAppntDirection enum: - Unknown - Incoming - Outgoing - SaintAll type: string Type: description: >- 1 = app, 2 = doc, 3 = email, 4 = fax, 5 = phone, 6 = todo - see EAppntRecordTypes enum: - Unknown - Appointment - Document - Email - Fax - Phone - ToDo - MailMergeDraft - MailMergeFinal - Report - SaintAll type: string Tooltip: description: Tooltip or other description type: string Deleted: description: If true, the Task list item is deleted type: boolean IntentId: format: int32 description: Link to the intention of this kind of task (used by SAINT) type: integer Rank: format: int32 description: Rank order type: integer IsDefaultAlldayEvent: description: True if all day event type: boolean IsDefaultFree: description: True if free, false if busy type: boolean IsDefaultPublished: description: Published to external persons type: boolean ColorIndex: description: JAP enum: - LightBlue - DarkBlue - LightGray - DarkGray - LightGreen - DarkGreen - LightYellow - DarkYellow - LightRed - DarkRed - BlueAlt1 - BlueAlt2 - BlueAlt3 - GrayAlt1 - GrayAlt2 - GrayAlt3 - GreenAlt1 - GreenAlt2 - GreenAlt3 - YellowAlt1 - YellowAlt2 - YellowAlt3 - RedAlt1 - RedAlt2 - RedAlt3 type: string DefaultVideomeetingStatus: description: >- Default video-meeting status for meetings created in SuperOffice CRM. enum: - NoChange - VideoMeetingOn - VideoMeetingOff type: string TableRight: $ref: '#/components/schemas/SuperOffice.CRM.Security.TableRight' FieldProperties: description: >- Field property dictionary mapping field names to field access rights. type: object additionalProperties: $ref: '#/components/schemas/SuperOffice.CRM.Security.FieldProperty' SuperOffice.CRM.Security.TableRight: description: "Wraps a table right together with an explanatory reason.\r\nCode can indicate why access is restricted." type: object properties: Mask: type: string Reason: type: string SuperOffice.CRM.Security.FieldProperty: description: >- Class holding properties like field length, field type about a field in the carrier. type: object properties: FieldRight: $ref: '#/components/schemas/SuperOffice.CRM.Security.FieldRight' FieldType: type: string FieldLength: format: int32 description: '' type: integer SuperOffice.CRM.Security.FieldRight: description: "Wraps the field right together with an explanatory reason.\r\nAlso adds logical operators to the field rights so that they can be easily combined." type: object properties: Mask: type: string Reason: type: string ```` ## Related topics - [Post Task List Item Heading](/en/api/reference/restful/rest/list_task/post-task-list-item-heading.md) - [NSTaskListItem](/en/automation/crmscript/reference/CRMScript.NetServer.NSTaskListItem.md) - [Get Task List Items](/en/api/reference/restful/agent/appointment_agent/get-task-list-items.md) - [Get Task List Item](/en/api/reference/restful/rest/list_task/get-task-list-item.md) - [Put Task List Item](/en/api/reference/restful/rest/list_task/put-task-list-item.md) - [Delete Task List Item](/en/api/reference/restful/rest/list_task/delete-task-list-item.md)