slackLists.items.create method

Usage info

Lists are only available to Slack workspaces on a paid plan.

This method is used to create a new item, also known as a record, in an existing List.

The item will be created with the field values specified in the initial_fields parameter. Each field corresponds to a column in the List and must reference a valid column_id.

Sample requests data

Creating items

Basic item creation

Provide field values using the initial_fields parameter:

{
  "list_id": "F1234ABCD",
  "initial_fields": [
    {
      "column_id": "Col10000000",
      "rich_text": [
        {
          "type": "rich_text",
          "elements": [
            {
              "type": "rich_text_section", 
              "elements": [
                {
                  "type": "text",
                  "text": "Complete project documentation"
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}

Duplicating items

Create a copy of an existing item by specifying the duplicated_item_id:

{
  "list_id": "F1234ABCD", 
  "duplicated_item_id": "Rec12345678"
}

Creating subtasks

Create a subtask by specifying the parent_item_id:

{
  "list_id": "F1234ABCD",
  "parent_item_id": "Rec12345678", 
  "initial_fields": [
    {
      "column_id": "Col10000000",
      "select": ["OptHIGH123"]
    }
  ]
}

Field types

The initial_fields parameter supports all column types available in Lists. The supported field formats are as follows:

Text field (rich_text)

{
  "column_id": "Col123",
  "rich_text": [
    {
      "type": "rich_text",
      "elements": [
        {
          "type": "rich_text_section",
          "elements": [
            {
              "type": "text",
              "text": "Your text content"
            }
          ]
        }
      ]
    }
  ]
}

User field

{
  "column_id": "Col123",
  "user": ["U1234567", "U2345678"]
}

Date field

{
  "column_id": "Col123", 
  "date": ["2024-12-31"]
}

Select field

{
  "column_id": "Col123",
  "select": ["OptionId123"]
}

Checkbox field

{
  "column_id": "Col123",
  "checkbox": true
}

Number field

{
  "column_id": "Col123",
  "number": [5000]
}

Email Field

{
  "column_id": "Col123",
  "email": ["contact@example.com"]
}

Phone field

{
  "column_id": "Col123", 
  "phone": ["+1-555-123-4567"]
}

Attachment field

{
  "column_id": "Col123",
  "attachment": ["F1234567890"]
}

Link field

{
  "column_id": "Col123",
  "link": [
    {
      "original_url": "https://example.com",
      "display_as_url": false,
      "display_name": "Example Website"
    }
  ]
}

Message field

{
  "column_id": "Col123",
  "message": ["https://yourteam.slack.com/archives/C1234567890/p1234567890123456"]
}

Rating field

{
  "column_id": "Col123",
  "rating": [4]
}

Timestamp Field

{
  "column_id": "Col123",
  "timestamp": [1704067200]
}

Channel field

{
  "column_id": "Col123",
  "channel": ["C1234567890"]
}

Reference field

{
  "column_id": "Col123",
  "reference": [
    {
      "file": {
        "file_id": "F1234567890"
      }
    }
  ]
}

Response Format

The response includes the created item with all its field values, plus metadata:

• id: The unique identifier for the created item.
• list_id: The List the item belongs to.
• date_created: Unix timestamp when the item was created.
• created_by: User ID of the user who created the item.
• updated_by: User ID of the user who last updated the item.
• updated_timestamp: String timestamp of last update.
• parent_record_id: Present if this is a subtask.
• fields: Array of all field values with their formatted representations.

Response