Snippets — Wahlu API Docs

Snippets are reusable blocks of text — hashtag sets, CTAs, signatures, or any content you use repeatedly in posts.

List snippets

GET/v1/brands/:brand_id/snippets

Returns all snippets for a brand. Requires snippets:read.

Query parameters

Parameter	Type	Description
`page`	integer	Page number. Defaults to 1.
`limit`	integer	Items per page. Defaults to 50, max 100.

curl

curl https://api.wahlu.com/v1/brands/brand_abc123/snippets \
  -H "Authorization: Bearer wahlu_live_your_api_key_here"

Response

{
  "success": true,
  "data": [
    {
      "id": "snippet_abc123",
      "name": "Standard Hashtags",
      "text": "#socialmedia #marketing #contentcreation #wahlu",
      "label_ids": [],
      "created_at": "2026-01-20T10:00:00Z",
      "updated_at": "2026-01-20T10:00:00Z"
    },
    {
      "id": "snippet_def456",
      "name": "CTA — Free Trial",
      "text": "Start your 7-day trial at wahlu.com",
      "label_ids": ["label_promo"],
      "created_at": "2026-01-20T10:00:00Z",
      "updated_at": "2026-01-20T10:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 50,
    "has_more": false
  }
}

Response fields

Parameter	Type	Description
`id`	string	Unique snippet identifier.
`name`	string \| null	Snippet display name.
`text`	string \| null	The snippet text content.
`label_ids`	string[]	Label IDs attached to this snippet.
`created_at`	string	ISO 8601 creation timestamp.
`updated_at`	string	ISO 8601 last-updated timestamp.

Create a snippet

POST/v1/brands/:brand_id/snippets

Creates a new snippet. Requires snippets:write. All fields are optional.

Request body

Parameter	Type	Description
`name`	string	A descriptive name. Max 200 characters.
`text`	string	The snippet text content. Max 10,000 characters.
`label_ids`	string[]	Label IDs to attach. Max 50 items.

curl

curl -X POST https://api.wahlu.com/v1/brands/brand_abc123/snippets \
  -H "Authorization: Bearer wahlu_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Sign-off",
    "text": "— The Acme Team"
  }'

Update a snippet

PATCH/v1/brands/:brand_id/snippets/:snippet_id

Updates a snippet. Only provided fields are changed. Requires snippets:write.

Request body

Same fields as create — all optional.

Delete a snippet

DELETE/v1/brands/:brand_id/snippets/:snippet_id

Deletes a snippet. Requires snippets:write.