---
title: "Add several Next Steps"
method: POST
path: "/v3/next-steps/bulk"
tags: ["Next Steps"]
---

# Add several Next Steps

`POST /v3/next-steps/bulk`

Adds up to 5 tasks to the team's Next Steps board in one call. Use this to turn the actions you just recommended into work the user can track, instead of leaving them in the chat: one call, one confirmation, most important first. A task that repeats something already on the board is skipped automatically, so there is no need to read the list first and it is safe to run again after the same analysis. Returns what was added and what was skipped, with the reason for each - tell the user both.

## Request body

- object
  - `teamId` string
  - `tasks` object[], required — The tasks to add, most important first. Give each one a title that says what to do, and notes carrying the evidence behind it.
    - `title` string, required — What needs doing, in one line.
    - `notes` string, nullable — Optional detail: why it matters, or how to do it.
    - `category` 'rankings' | 'technical' | 'content' | 'articles' | 'aiVisibility' | 'authority' — Which part of the work this belongs to.
    - `link` string, nullable — Optional link to open with the task: an in-app path or an http(s) URL.
    - `priority` 'now' | 'next' | 'later' — How urgent it is (defaults to next).

## Other responses

- `400` — Default Response

---

[API](https://skmtc.net/snowseo/apis/snowseo-api.md) · [All operations](https://skmtc.net/snowseo/apis/snowseo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/snowseo/snowseo-api/revisions/c8f1f876a92c/schema)