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
- You create a form via the API. It describes the sections, fields, and signers you want.
- You publish the form and share its public URL (or a prefilled link) with a respondent.
- The respondent fills and submits the form.
- The submission is sent to Penneo Sign for signing.
- You retrieve the submitted answers and the signed PDF through the API.
Forms and submissions
| Concept | What it is |
|---|---|
| Form | The reusable template you define. Identified by an formId (UUID). |
| Submission | One respondent's completed form. Identified by a submissionId (UUID). |
A single form (externalId) produces many submissions.
| ID | Identifies | You use it to |
|---|---|---|
formId | The form | Update, publish, or archive the form |
submissionId | A single submission | Retrieve the answers for that submission |
requestId | A prefilled request | Retrieve the answers for that request |
Where to go next
- Getting Started — authenticate and create your first form end to end.
- Forms — build forms: field types, signers, conditional logic, merge fields, options, and managing the form lifecycle.
- Prefilled Requests — send a respondent a link that is already filled in, with signers attached and reminders enabled.
- Submissions — list submissions and retrieve submitted data.
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.
Updated 19 days ago
