Contents

API reference / Keywords

Create a keyword group

POST /api/v1/projects/{project}/groups

create_keyword_group Write MCP tool

A full-access key (ss_sk_…), or an editor or owner signed in.

Parameters

NameTypeDescription
project required
path
string The project's id.

Request body

JSON, sent with Content-Type: application/json.

NameTypeDescription
name required string
1–60 characters
Group name.
kind string
One of: brand competitor custom
color string Hex colour.

Example

curl -X POST "https://sniffington.com/api/v1/projects/{project}/groups" \
  -H "Authorization: Bearer $SCOUT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Acme"}'