BUbuttondown
Forms

Retrieve Form

Changed on

Retrieve a specific form by its ID

get/forms/{id}

Request

  • Base URL
    https://api.buttondown.com/v1
  • URL
    https://api.buttondown.com/v1/forms/{id}
  • Auth
    API key in header Authorization

Path parameters

idstring required

Response

OK

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.

titlestring required

The human-readable title of the form, shown in the UI and on the hosted form page.

slugstring required

A URL-safe identifier used in the form's hosted URL (e.g. /forms/{slug}). Must be unique per newsletter.

bodystring required

Markdown body rendered above the subscribe fields on the hosted form page.

cssstring required

Custom CSS applied to the hosted form page.

success_bodystring required

Markdown shown to the subscriber after a successful submission.

surveysstring[] required

IDs of surveys to attach to this form. Responses are associated with the submitting subscriber.

tagsstring[] required

UUIDs or TypeIDs of tags applied to subscribers who sign up through this form.

adminboolean required

If true, the form acts as an admin-only signup form — it skips confirmation and can accept additional subscriber fields.

status'active' | 'inactive' required

An enumeration.

subscriber_countinteger required

The number of subscribers who signed up through this form.

confirmed_subscriber_countinteger required

The number of confirmed subscribers who signed up through this form.

page_view_countinteger required

The number of page views for this form.

Example response

{
  "tags": [
    "sub_tag_0k28edc3fw896bp4mrhc535z5k"
  ]
}

Changes