Add Tasks via API | Documentation

You can programmatically create tasks on a t0ggles board using the API. This feature is available exclusively to board owners and requires an API key that can be generated in the board settings.

#Step 1: Generate API Key

Only board owners can generate API keys.

Open your board and go to Board Settings → Services.
Under API Key, click the Generate API Key button.
Copy the generated key and store it somewhere safe — this is the only time you will see the full token.
On future visits, only a masked portion of the key will be visible.

#Step 2: Make API Request

Use the following endpoint to create tasks:

POST https://t0ggles.com/api/v1/tasks

#Headers

{
  "Content-Type": "application/json",
  "Authorization": "Bearer YOUR_API_KEY"
}

#Payload

The tasks parameter is an array of task objects. Each object supports the following fields:

#Required fields

Field	Type	Description
`title`	`string`	Task title
`projectKey`	`string`	Project key (e.g. `SWIPER`, `OTHER`)
`descriptionType`	`string`	One of: `markdown`, `html`, `text`
`descriptionContent`	`string`	Task description

#Optional fields

Field	Type	Description
`assignedUserEmail`	`string`	Email of the board member
`priority`	`string`	One of: `low`, `medium`, `high`
`pinToTop`	`boolean`	Whether to pin the task to the top
`tags`	`array`	Array of tag names
`startDate`, `dueDate`	`date`	JS `Date` object or ISO date string
`properties`	`object`	Map of property names to values

#Response

Field	Type	Description
`success`	boolean	Indicates success
`error`	boolean	Indicates error (if any)
`message`	string	Error message (if error is true)

#Example

const res = await fetch('https://t0ggles.com/api/v1/tasks', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    Authorization: 'Bearer YOUR_API_KEY',
  },
  body: JSON.stringify({
    tasks: [
      {
        title: 'Launch Campaign Planning',
        projectKey: 'MARKETING',
        assignedUserEmail: '[email protected]',
        priority: 'high',
        pinToTop: true,
        tags: ['Urgent', 'Campaign'],
        startDate: new Date(2025, 3, 15),
        dueDate: new Date(2025, 3, 25),
        descriptionType: 'markdown',
        descriptionContent: `
          ## Launch Campaign Timeline

          Tasks to complete before product launch:

          - Finalize creatives and copy
          - Schedule posts on all platforms
          - Coordinate with influencers

          **Deadline:** March 20

          Contact: [Julia](mailto:[email protected])
        `,
        properties: {
          // text type property
          'Campaign Type': 'Product Launch',
          // number type property
          'Estimated Budget': 8000,
          // checkbox type property
          'Assets Ready': false,
          // toggle type property
          'Approval Needed': true,
          // date type property
          'Kickoff Date': new Date(2025, 3, 15),
          // url type property
          'Landing Page URL': 'https://company.com/launch',
          // email type property
          'Marketing Lead': '[email protected]',
          // person type property
          'Stakeholder': '[email protected]',
          // select type property
          'Region': 'North America',
          // multi-select type property
          'Channels': ['Instagram', 'LinkedIn'],
        },
      },
    ],
  }),
});

// { success: true } or { error: true, message: 'error message' }
console.log(await res.json());

✅ Now your app or script can create tasks in t0ggles dynamically!