1. Documentation
  3. Forms
  5. Overview
Open Specter
  • Introduction
  • Quickstart
  • Authentication
  • Errors
  • Rate limits
  • Best practices
  • Overview
  • Best practices
  • Create a key
  • Read and write
  • Overview
  • Best practices
  • Hosted page
  • Submit from your code
  • Drafts, files and corrections

Overview

Collect records from people with a published Specter form — no key.

Loading documentation…

Read and write< PreviousBest practicesNext >

On this page

How a form is madeThree ways to use itForm or key?

A Specter form collects answers from people — merchants, applicants, anyone with the link — and files each submission as a row on a board or page. It needs no key: it is public by design, so it is the safe way to put a form on a website.

How a form is made

  • From a board. Open the board and ask Neo to make a form for this board. It asks one question per column a person can fill, in the board's order; starred columns are required; choice questions offer the column's own options. It goes live at once.
  • On the Forms page. Build one by hand — sections, file questions, a signature at the end.

Columns a stranger can't fill are never asked: people, relations, files already pinned, formulas.

Three ways to use it

WayForPage
The hosted pageLink to it or open it from a buttonHosted page
Your own HTMLKeep your site's form, post the answers to SpecterSubmit from your code
Save and resumeLong forms filled over days, with filesDrafts, files and corrections

Form or key?

A form is for people typing into a page. A board key is for your server sending records it already has — a lead vendor, a sync, a script. Never put a key in a web page.