> ## Documentation Index
> Fetch the complete documentation index at: https://docs.postsyncer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Snippets

> Saved snippets and hashtag groups your team drops into posts

## Snippets

A snippet is text a workspace keeps to reuse in posts: a sign-off, a call to action, a disclaimer. A hashtag group is a snippet of the `hashtags` kind, such as `#launch #buildinpublic`. In the app, both are under the **Snippets** button in the post composer.

Every plan has snippets, Free included.

### The snippet object

| Field | Type | Description |
| - | - | - |
| `id` | integer | Unique identifier of the snippet |
| `workspace_id` | integer | The workspace it belongs to |
| `kind` | string | `snippet` (any saved text) or `hashtags` (a hashtag group) |
| `name` | string | Short name shown in the list |
| `body` | string | The text that goes into the post |
| `created_by` | integer or null | Id of the person who saved it. `null` once that person's account is deleted; the snippet stays. |
| `created_at` | string | When it was saved (ISO 8601) |
| `updated_at` | string | When it was last changed (ISO 8601) |

```json theme={null}
{
  "id": 31,
  "workspace_id": 12,
  "kind": "hashtags",
  "name": "Launch tags",
  "body": "#launch #buildinpublic #saas",
  "created_by": 7,
  "created_at": "2026-11-17T09:12:44+00:00",
  "updated_at": "2026-11-17T09:12:44+00:00"
}
```

### Rules

* `kind` is `snippet` or `hashtags`.
* `name` is 1 to 80 characters. Spaces at the start and end are removed before it is counted and saved. Names need not be unique.
* `body` is 1 to 5,000 characters. Spaces and line breaks at the start and end are removed too.
* A workspace keeps at most 500 snippets, both kinds together. Saving one more is refused with `422` and the message `This workspace has 500 saved snippets, the most it can keep. Delete one to save another.`
* Lists are ordered by `kind`, then `name`.

### Permissions

API keys use the `snippets` permission group. The same permission gates the matching [MCP tool](https://docs.postsyncer.com/mcp/tools-reference.md#snippets).

| Permission | Allows | MCP tool |
| - | - | - |
| `snippets:read` | [List snippets](https://docs.postsyncer.com/api-reference/snippets/list.md) | `list-snippets` |
| `snippets:create` | [Create a snippet](https://docs.postsyncer.com/api-reference/snippets/create.md) | `create-snippet` |
| `snippets:update` | [Update a snippet](https://docs.postsyncer.com/api-reference/snippets/update.md) | `update-snippet` |
| `snippets:delete` | [Delete a snippet](https://docs.postsyncer.com/api-reference/snippets/delete.md) | `delete-snippet` |

The person who owns the key also needs a role that allows it in the snippet's workspace: every role can read snippets, and owners, managers, content managers and content creators can create, edit and delete them (the same roles as labels). If not, the request is refused with `403`.

A snippet of a workspace the key's person is not in is answered with `404`, as if it did not exist.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.