Introduction

Penneo Collect lets you build online forms, collect data and files from your respondents, and turn each submission into a signed document, all through the API.

This overview explains the core concepts. Each feature then has its own page with the details and examples.

The flow

  1. You create a form via the API. It describes the sections, fields, and signers you want.
  2. You publish the form and share its public URL (or a prefilled link) with a respondent.
  3. The respondent fills and submits the form.
  4. The submission is sent to Penneo Sign for signing.
  5. You retrieve the submitted answers and the signed PDF through the API.

Forms and submissions

ConceptWhat it is
FormThe reusable template you define. Identified by an formId (UUID).
SubmissionOne respondent's completed form. Identified by a submissionId (UUID).

A single form (externalId) produces many submissions.

IDIdentifiesYou use it to
formIdThe formUpdate, publish, or archive the form
submissionIdA single submissionRetrieve the answers for that submission
requestIdA prefilled requestRetrieve the answers for that request

Where to go next

Base URL and authentication

All endpoints live under:

https://app.penneo.com/collect/api

Every request needs a JWT: Authorization: Bearer <token>. See the Authentication Guide for how to obtain one.