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

# Add a Next Step

`POST /v3/next-steps/`

Adds a task the user wrote themselves to the team's Next Steps board. It sits alongside SnowSEO's suggestions and is never changed, completed, or removed by a refresh.

## Request body

- object
  - `teamId` string
  - `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
- `409` — 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/94875d963953/schema)