BUbuttondown
Forms

Update Form

Changed on

Update a form's properties

patch/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

Request body

titlestring nullable

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

slugstring nullable

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

bodystring nullable

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

cssstring nullable

Custom CSS applied to the hosted form page.

success_bodystring nullable

Markdown shown to the subscriber after a successful submission.

surveysstring[] nullable

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

tagsstring[] nullable

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

adminboolean nullable

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

status'active' | 'inactive'

An enumeration.

Example request

{
  "surveys": [
    "srv_01h8abcdefghjkmnpqrstvwxyz"
  ],
  "tags": [
    "sub_tag_0k28edc3fw896bp4mrhc535z5k"
  ]
}

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