<!--
{
  "availability" : [
    "iOS: 11.0.0 - 15.0.0",
    "iPadOS: 11.0.0 - 15.0.0",
    "macCatalyst: 13.1.0 - 15.0.0",
    "visionOS: 1.0.0 - 1.0.0",
    "watchOS: 4.0.0 - 8.0.0"
  ],
  "documentType" : "symbol",
  "framework" : "SiriKit",
  "identifier" : "/documentation/Intents/INCreateTaskListIntent",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "Intents"
    ],
    "preciseIdentifier" : "c:objc(cs)INCreateTaskListIntent"
  },
  "title" : "INCreateTaskListIntent"
}
-->

# INCreateTaskListIntent

A request to create a new task list.

```
class INCreateTaskListIntent
```

## Overview

Siri creates an [`INCreateTaskListIntent`](/documentation/Intents/INCreateTaskListIntent) object when the user asks to create a new task list. The intent object can contain the title of the task list, a set of initial tasks, and possibly the group in which to create the task list.

To handle this intent, the handler object in your Intents extension must adopt the [`INCreateTaskListIntentHandling`](/documentation/Intents/INCreateTaskListIntentHandling) protocol. Your handler should confirm the request and create an [`INCreateTaskListIntentResponse`](/documentation/Intents/INCreateTaskListIntentResponse) object with the updated task list.

### Additional Intent Attributes

The following table lists additional attributes of this intent object:

|Attribute                      |Description |
|-------------------------------|------------|
|Supported by                   |Siri Intents|
|Always requires unlocked device|No          |

### Example Phrases

Users can ask Siri to create task lists in a variety of ways. The table below provides a few sample phrases in different languages. You can use these phrases during testing to trigger your intents. This list isn’t exhaustive and Siri may recognize many other phrases.

|Locale|Example 1                                                    |Example 2                                              |
|------|-------------------------------------------------------------|-------------------------------------------------------|
|en    |Create a shopping list with bananas on `<appName>`           |Start a list called Wedding Prep                       |
|zh_CN |建立一个购物列表添加香蕉 (在 `<appName>` 上)                               |创建一个列表叫做婚礼准备                                           |
|zh_HK |(喺 `<appName>` 入面)新增一個購物清單內容係香蕉                              |新增一個叫做準備婚禮嘅列表                                          |
|zh_TW |新增一個購物清單香蕉(在 `<appName>` 上)                                  |新增一個叫做婚禮準備的列表                                          |
|yue_CN|(喺 `<appName>` 入面)新增一个购物清单内容系香蕉                              |新增一个叫做准备婚礼嘅列表                                          |
|ar    |`<appName>` أنشئ قائمة تسوق بالموز على                       |إبدأ قائمة باسم التحضير للعرس                          |
|da    |opret en indkøbsliste med bananer (i `<appName>`)            |start en liste kaldet bryllupsforberedelse             |
|de    |Erstelle eine Einkaufsliste mit Bananen (auf `<appName>` )   |Erstelle eine Liste mit dem Namen Hochzeitsvorbereitung|
|es    |Crea una lista de la compra con plátanos (con `<appName>` )  |Crea una lista que se llame Preparativos de la boda    |
|fi    |Luo ostoslista ja lisää siihen banaaneja (apissa `<appName>`)|Luo uusi lista nimeltä Häävalmistelut                  |
|fr    |Créer une liste de courses avec des bananes (sur `<appName>`)|Commence une liste nommée Préparation du mariage       |
|he    |`<appName>`תצרי רשימת קניות עם בננות ב                       |תתחילי רשימה שנקראת הכנות לחתונה                       |
|it    |Crea una lista shopping con banane (su `<appName>`)          |Inizia una lista chiamata preparazione matrimonio      |
|ja    |(<appName>で)ショッピングリストを作成してバナナと書いて                            |結婚式の準備というリストを作成                                        |
|ko    |(`<appName>` 에) 바나나로 쇼핑 리스트 만들어줘                             |웨딩 준비라는 이름의 리스트 생성해줘                                   |
|ms    |Cipta senarai beli belah dengan pisang (pada `<appName>`)    |Mulakan senarai bernama Persediaan Perkahwinan         |
|nb    |Lag en handleliste med bananer (i `<appName>`)               |Start en liste som heter forberedelser til bryllup     |
|nl    |Maak een boodschappenlijst met bananen (in `<appName>`)      |Start een lijst genaamd huwelijksvoorbereidingen       |
|pt    |Crie uma lista de compras com bananas (no `<appName>`)       |Iniciar uma lista chamada Preparação para o Casamento  |
|ru    |Создать список покупок содержащий бананы (в `<appName>`)     |Создать список под названием Подготовка к свадьбе      |
|sv    |Skapa en inköpslista med bananer (i `<appName>`)             |Starta en lista som heter bröllopsplanering            |
|th    |สร้างลิสต์รายการสิ่งของที่ต้องซื้อแล้วเพิ่มผลไม้ (บนแอพ `<appName>`)       |สร้างลิสต์ชื่อว่าสิ่งที่ต้องเตรียมสำหรับงานแต่งงาน                    |
|tr    |(<appName>’de) Alınacaklar listesi yarat                     |Düğün hazırlıkları adlı bir liste oluştur              |

In the preceding examples, `<appName>` represents the name of the app whose Intents extension handles the request.

## Topics

### Initializing the Intent Object

[`-  initWithTitle:taskTitles:groupName:`](/documentation/Intents/INCreateTaskListIntent/init(title:taskTitles:groupName:))

Initializes the intent object with the specified task list details.

### Getting the Task List Details

[`title`](/documentation/Intents/INCreateTaskListIntent/title)

The title of the task list.

[`taskTitles`](/documentation/Intents/INCreateTaskListIntent/taskTitles)

An array of strings containing the titles for individual tasks to add to the new task list.

[`groupName`](/documentation/Intents/INCreateTaskListIntent/groupName)

The group that contains the task list.

## Relationships

### Conforms To

[`NSSecureCoding`](/documentation/Foundation/NSSecureCoding)

[`NSCopying`](/documentation/Foundation/NSCopying)

[`NSObjectProtocol`](/documentation/ObjectiveC/NSObjectProtocol)

[`CustomDebugStringConvertible`](/documentation/Swift/CustomDebugStringConvertible)

[`INIntentSetImageKeyPath`](/documentation/Intents/INIntentSetImageKeyPath)

[`CVarArg`](/documentation/Swift/CVarArg)

[`Hashable`](/documentation/Swift/Hashable)

[`NSCoding`](/documentation/Foundation/NSCoding)

[`CustomStringConvertible`](/documentation/Swift/CustomStringConvertible)

[`Equatable`](/documentation/Swift/Equatable)

### Inherits From

[`INIntent`](/documentation/Intents/INIntent)

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)