Skip to main content
POST

Create Snippet

Saves a snippet or hashtag group in a workspace, so your team can drop it into posts from the composer. Every plan has snippets, Free included. A workspace keeps at most 500.

Request

integer
required
The ID of the workspace the snippet belongs to
string
required
snippet for any saved text, hashtags for a hashtag group
string
required
Short name shown in the list, 1 to 80 characters after spaces at the start and end are removed. Names need not be unique.
string
required
The text that goes into the post, up to 5,000 characters

Response

201 Created with the new snippet object.

Code Examples

Error Codes

Unauthorized
Missing or invalid API token
Forbidden
The key does not have the snippets:create permission, or the key’s person’s role in the workspace does not allow creating snippets
Unprocessable Entity
Validation errors: an unknown workspace_id or one the key’s person is not in, a kind other than snippet or hashtags, a name over 80 characters, an empty or over-5,000-character body. Also when the workspace already keeps 500 snippets: This workspace has 500 saved snippets, the most it can keep. Delete one to save another.