---
title: "create_todo_list"
url: "https://docs.slack.dev/tools/deno-slack-sdk/reference/connector-functions/basecamp/create_todo_list"
type: "guide"
---

Source: https://docs.slack.dev/tools/deno-slack-sdk/reference/connector-functions/basecamp/create_todo_list

# create_todo_list

## Facts {#facts}

**Description**Create a to-do list

**Schema**`Connectors.Basecamp.functions.CreateTodoList`

**Service**`Basecamp`

## Input parameters {#input-parameters}

### Required input parameters

**`basecamp_access_token`**`slack#/types/credential/oauth2`Required

Basecamp access token. See the [authentication](#authentication) section for details.

**`domain`**`string`Required

The URL of the Basecamp domain that contains the project in which a new to-do list will be created

_Examples_

`https://123.basecamp.com/12345678`

**`name`**`string`Required

The name of the to-do list

_Examples_

`Preflight items`

**`project_id`**`string`Required

The ID of the project in which to create a new to-do list

_Examples_

`12345`

### Optional input parameters

**`description`**`string`Optional

Description

## Output parameters {#output-parameters}

### Required output parameters

**`id`**`string`Required

To-do list ID

**`name`**`string`Required

To-do list name

**`url`**`string`Required

To-do list URL

## Authentication {#authentication}

### End-user authentication

User workflows that include a connector function relying on end-user authentication can only be started with a link trigger.

```
{
  "basecamp_access_token": {
    "credential_source": "END_USER"
  }
}
```

**End-user experience:** User will be prompted to link their external account via OAuth when they first start the workflow that contains this connector.

**Developer experience:** Developer does not have to implement authentication in the app.

## Usage info {#usage-info}

First, import `Connectors` from `deno-slack-hub` into your project's `import_map.json` file, like this:

import\_map.json

```js
{
    "imports": {
      "deno-slack-hub/": "https://deno.land/x/deno_slack_hub@2.2.0/",
      "deno-slack-sdk/": "https://deno.land/x/deno_slack_sdk@2.14.2/",
      "deno-slack-api/": "https://deno.land/x/deno_slack_api@2.8.0/"
    }
  }
```

Next, import `Connectors` at the top of your workflow's definition file:

my\_workflow\_file.ts

```ts
import { Connectors } from "deno-slack-hub/mod.ts";
```

Finally, add the connector as a step in your [workflow](https://docs.slack.dev/tools/deno-slack-sdk/guides/creating-workflows.md) just like you would a [Slack function](https://docs.slack.dev/tools/deno-slack-sdk/guides/creating-slack-functions.md).

my\_workflow\_file.ts

```ts
SomeWorkflow.addStep(
  Connectors.Basecamp.functions.CreateTodoList, {
  //...
```

🧙🏼 **Your admin may need to approve the connector first.** If your workspace has been configured to only allow admin-approved apps, the CLI will prompt you to send an [admin approval request](https://docs.slack.dev/tools/deno-slack-sdk/guides/controlling-permissions-for-admins.md#admin-connectors) the first time you try to use a connector that hasn't been approved by an admin yet. While waiting for admin approval, the CLI may report an error like this:

```
Workflow function X is referring to an unknown step output parameter Y
```

You can safely ignore this error; it will go away as soon as your workspace admin approves your request to use the connector.
