Form
A Form is a set of fields someone fills in on a Site or in a Message, producing a Lead, Evidence, or a Thing.
Properties
| Property | Type | Required | Description |
|---|---|---|---|
fields | json | required | The fields and their types. |
Object
{
"$id": "https: //api.sb/ quietcopy.com/ forms/ form_1",
"$type": "Form",
"fields": {}
}Relationships
- A Form captures many Leads: each Form submission creates a Lead.
captures, inversecapturedBy. - A Form is embedded in many Pages: Forms sit on Pages; one Form appears on many Pages.
embeddedIn, inverseembeds.
Verbs
createCreates a Form.POST /{namespace}/formsgetReturns one Form by id.GET /{namespace}/forms/{id}listReturns Forms, newest first, one page at a time.GET /{namespace}/formsupdateChanges the given properties of a Form.PATCH /{namespace}/forms/{id}deleteDeletes a Form; its history is kept.DELETE /{namespace}/forms/{id}
Permissions
Which Access level may call each Verb. One-way Verbs wait their delay window.
| Operation | owner | admin | member | viewer |
|---|---|---|---|---|
Form.create | Yes | Yes | Yes | No |
Form.get | Yes | Yes | Yes | Yes |
Form.list | Yes | Yes | Yes | Yes |
Form.update | Yes | Yes | Yes | No |
Form.delete | Yes | Yes | Yes | No |
Call it
Add a form to TutorLoop.Example
The booking Form on a home-inspector directory asks for the address, the closing date, and a phone number. Each submission creates a Lead and offers it to three inspectors.