Form replies

Email me about every reply to this form

Off by default. The first reply to a form is always announced, and a monthly summary covers the rest — this asks for one email per reply instead. Part of a paid plan; saving replies is not.

patch/sites/{siteId}/forms/{formId}/notify

Request

  • Base URL: https://api.nippy.host
  • URL: https://api.nippy.host/sites/{siteId}/forms/{formId}/notify
  • Auth: bearer (a scheme the document does not define)

Path parameters

siteIdstring required

Site UUID

formIdstring required

Form UUID

Request body

notifyEveryReplyboolean required

When true, every reply to this form is emailed as it arrives. When false, only the first reply to a form is announced, and the monthly summary covers the rest.

Response

idstring required

Form UUID

siteIdstring required

Site UUID this form belongs to

namestring required

Display name — derived from a nearby heading or the page path, or set by the owner.

pagePathstring required

Path of the page the form appears on

fieldLabelsstring[] required

Field labels as last seen, in the order they appear.

captureEnabledboolean required

Whether replies to this form are stored. Defaults to whether the form looks like a way to contact the owner; the owner decides from then on.

notifyEveryReplyboolean required

Whether the owner asked to be emailed about every reply to this form, not just the first. Paid plans only; replies are saved on every plan.

submissionCountnumber required

Number of replies stored for this form

lastSubmissionAtstring nullable required

ISO timestamp of the most recent reply, or null

supersedesFormIdstring nullable required

When this form replaced an earlier one whose fields differed, the id of that earlier form. Its replies are still stored against it; merging is offered rather than done automatically, because the match is a heuristic and a merge cannot be undone. Null when there is nothing to merge.

createdAtstring required

ISO timestamp the form was first seen

Changes

No recorded changes to this operation across all 1 revision of this API.