Sign in
Snippets

Create Snippet

Create a new snippet

post/snippets

Request body

identifierstring required

A unique, newsletter-scoped slug used to reference the snippet inside email content (e.g. {{ snippets.footer }}). Must be unique per newsletter.

namestring required

A human-readable name for the snippet, shown in the Buttondown UI.

contentstring

The body of the snippet, substituted wherever the snippet is referenced. Interpreted according to mode.

mode'fancy' | 'naked' | 'plaintext'

An enumeration.

Example request

{
  "identifier": "footer",
  "name": "Footer",
  "content": "Thanks for reading!"
}

Response

Created

idstring required

A unique TypeID associated with the object.

creation_datestring date-time required

The date and time at which the object was first created.

identifierstring required

A unique, newsletter-scoped slug used to reference the snippet inside email content (e.g. {{ snippets.footer }}). Must be unique per newsletter.

namestring required

A human-readable name for the snippet, shown in the Buttondown UI.

contentstring required

The body of the snippet, substituted wherever the snippet is referenced. Interpreted according to mode.

mode'fancy' | 'naked' | 'plaintext' required

An enumeration.

reference_countinteger

The number of emails that currently reference this snippet.

Changes