---
title: "Create Snippet"
method: POST
path: "/v3/portals/{portalId}/snippets"
tags: ["Snippets"]
---

# Create Snippet

`POST /v3/portals/{portalId}/snippets`

Creates a new custom snippet for this portal. Custom snippets can be used to display static content, documentation, or other information to developers. Title and Description properties may be provided in the frontmatter section of `content`. If you set values in both the `POST` request _and_ in the frontmatter, the values in the frontmatter will take precedence.

## Path parameters

- `portalId` string, uuid, required

## Request body

- CreatePortalSnippetRequest — Create a snippet in a portal.
  - `name` string, required — The unique name of a snippet in a portal.
  - `title` string — The display title of a snippet in a portal.
  - `content` string, required — The renderable markdown content of a page in a portal.
  - `visibility` 'public' | 'private' — Whether a snippet is publicly accessible to non-authenticated users. If not provided, the default_page_visibility value of the portal will be used.
  - `status` 'published' | 'unpublished' — Whether the resource is visible on a given portal. Defaults to unpublished.
  - `description` string

## Response `201`

Details about a snippet in a portal.

- PortalSnippetResponse — Details about a snippet in a portal.
  - `id` string, uuid, required — Contains a unique identifier used for this resource.
  - `name` string, required — The unique name of a snippet in a portal.
  - `title` string — The display title of a snippet in a portal.
  - `content` string, required — The renderable markdown content of a page in a portal.
  - `visibility` 'public' | 'private', required — Whether the resource is publicly accessible to non-authenticated users.
  - `status` 'published' | 'unpublished', required — Whether the resource is visible on a given portal. Defaults to unpublished.
  - `description` string
  - `created_at` string, date-time, required — An ISO-8601 timestamp representation of entity creation date.
  - `updated_at` string, date-time, required — An ISO-8601 timestamp representation of entity update date.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.net/kong/apis/konnect-api-beta.md) · [All operations](https://skmtc.net/kong/apis/konnect-api-beta/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kong/konnect-api-beta/versions/73b05fbfd2ef/schema)