# Penneo Documentation > Documentation for Penneo ## Guides: Authentication - [Authentication](https://developer.penneo.com/docs/authentication.md) - [Using OAuth](https://developer.penneo.com/docs/using-oauth.md): This documentation will focus on <>, which is the recommended Authentication method. For the full API Reference see [here](https://penneo.readme.io/reference). ## Guides: Penneo Sign documentation - [Simple case file creation](https://developer.penneo.com/docs/async-case-file-creation.md): The simple case file creation method is designed to provide maximum simplicity and efficiency by allowing you to submit an entire case file in one single request. - [Direct case file creation](https://developer.penneo.com/docs/sync-case-file-creation.md) - [Monitoring case file status](https://developer.penneo.com/docs/monitoring-case-file-status.md): Decide on your strategy for monitoring case file statuses. - [Webhooks](https://developer.penneo.com/docs/webhooks-vs-2.md): This guide walks you through creating and consuming webhooks for the Penneo platform. Webhooks allow you to receive real-time event notifications in your application whenever relevant events occur in… - [Polling](https://developer.penneo.com/docs/polling.md): This section outlines how to poll for both case file status and document status. - [Sign API integration use cases](https://developer.penneo.com/docs/api-integration-use-cases.md): Welcome to the use cases section. This guide is designed to help you understand the architectural choices available when integrating with the Penneo API. - [Distribution of signing links](https://developer.penneo.com/docs/distribution-of-signing-links.md) - [Tracking case file usage](https://developer.penneo.com/docs/integration-tracking-with-structured-data.md) - [Using email message templates on the Simple case file creation endpoint](https://developer.penneo.com/docs/using-email-message-templates-on-simple-case-file-creation.md): To use existing email message templates, you must fetch the template data first and then inject it into the Simple case file creation request. - [Microsoft Power Platform](https://developer.penneo.com/docs/microsoft-power-platform.md): Build Penneo Sign flows in Microsoft Power Automate with our certified connectors ## Guides: Penneo Collect documentation - [Introduction](https://developer.penneo.com/docs/collecting-data.md) - [Getting Started](https://developer.penneo.com/docs/collect-getting-started.md) - [Forms](https://developer.penneo.com/docs/collect-forms.md) - [Field Types & Validation](https://developer.penneo.com/docs/collect-field-types.md) - [Signers](https://developer.penneo.com/docs/collect-signers.md) - [Conditional Fields & Sections](https://developer.penneo.com/docs/collect-conditional-fields.md) - [Merge Fields](https://developer.penneo.com/docs/collect-merge-fields.md) - [Form Options](https://developer.penneo.com/docs/collect-form-options.md) - [Managing Forms](https://developer.penneo.com/docs/collect-managing-forms.md) - [Prefilled Requests](https://developer.penneo.com/docs/collect-prefilled-requests.md) - [Request Signers](https://developer.penneo.com/docs/collect-request-signers.md) - [Reminders](https://developer.penneo.com/docs/collect-reminders.md) - [Protected Requests](https://developer.penneo.com/docs/collect-protected-requests.md) - [Uploading Files](https://developer.penneo.com/docs/collect-request-files.md) - [Submissions](https://developer.penneo.com/docs/collect-submissions.md) ## Guides: Postman Collections - [Postman collection for Penneo API](https://developer.penneo.com/docs/postman-collection-for-penneo-api.md): Test the Penneo API end-to-end using our official Postman collection. - [Postman collection for Penneo Webhook](https://developer.penneo.com/docs/postman-collection-for-penneo-webhooks.md): Test Penneo's webhook API using our official Postman collection. Create and manage webhook subscriptions, fire test events to your endpoint, and inspect the exact payload structure. - [Postman collection for Penneo Collect](https://developer.penneo.com/docs/postman-collection-for-penneo-collect.md): Test Penneo's Collect API using our official Postman collection. Create and manage Collect forms, generate prefilled form links, and retrieve submission data and signed documents. ## Guides: Deprecation - [Deprecation overview](https://developer.penneo.com/docs/deprecation-overview.md) - [Migration guide: Webhook deprecation](https://developer.penneo.com/docs/migration-guide-webhook-deprecation.md): As part of our commitment to platform stability and security, Penneo is deprecating our legacy webhook service. This guide outlines the transition to our new **webhooks** infrastructure. ## API Reference: Authentication - [Authenticate a user with Penneo](https://developer.penneo.com/reference/oauth-authenticate-user.md): The browser will redirect the user to the Penneo Login page and, after a successful login, back to the specified `redirect_uri`.
A `code` parameter will be attached to the request so it can be… - [Obtain or refresh an access_token](https://developer.penneo.com/reference/oauth-refresh-token.md): Obtain a new `access_token` by exchanging an authorization `code`, a `refresh_token` or `api_keys`. - [Revoke a refresh_token](https://developer.penneo.com/reference/oauth-revoke-refresh-token.md): Revokes a `refresh_token` (RFC 7009). The confidential client must authenticate with `client_id` and `client_secret` in the body or via `Authorization: Basic` (RFC 6749 §2.3.1). The token is removed… - [Returns version](https://developer.penneo.com/reference/get-version.md): Returns version of the running app ## API Reference: Penneo simple Case File API - [Create a new case file with documents and signers](https://developer.penneo.com/reference/createcasefile.md): Creates a new case file in Penneo with the specified documents and signers. This endpoint accepts a multipart/form-data request containing JSON metadata and files. - [Check job status by UUID](https://developer.penneo.com/reference/checkjobstatus.md): Retrieves the current status of an asynchronous job by providing the job UUID and payload hash. This endpoint is used to poll for job completion status after submitting a case file creation request.… ## API Reference: Penneo Collect API - [Get submitted user data for given casefile](https://developer.penneo.com/reference/get_v1-casefiles-id-answers.md): Retrieve all submission data for a specific casefile. ### Requirements * The form **MUST** be in **ACTIVE** or **ARCHIVED** status to have submissions * Valid casefile ID is required ### Response… - [Get form by external ID](https://developer.penneo.com/reference/get_v1-forms-externalid.md): Retrieve a complete form definition by its external ID. ### What You Get * Form metadata (name, status, version, language) * All sections with their titles and descriptions * All fields with their… - [Update form](https://developer.penneo.com/reference/put_v1-forms-externalid.md): Update a form with sections and input fields. ### Behavior * If form is in **DRAFT** status: Updates the existing draft * If form is **ACTIVE**: Creates a new **DRAFT** version ### Query Parameters… - [Create a new form](https://developer.penneo.com/reference/post_v1-forms.md): Create a new form with sections and input fields. An optional boolean publish parameter can be set to publish the form on save. ### Section Requirements * Each section **MUST** include at least 1… - [Publish a form](https://developer.penneo.com/reference/post_v1-forms-externalid-publish.md): Publish a form to make it available for end-users to fill and sign. ### Requirements * Form **MUST** be in **DRAFT** status * Form must have at least one section with one field ### What Happens *… - [Publish a specific version of a form](https://developer.penneo.com/reference/post_v1-forms-externalid-publish-version.md): Publish a specific version of a form to make it available for end-users. ### Requirements * Form version **MUST** be in **DRAFT** status * Version number must exist for the given form * Form must… - [Archive a form](https://developer.penneo.com/reference/post_v1-forms-externalid-archive.md): Archive (unpublish) an active form to make it unavailable for new submissions. ### Requirements * Form **MUST** be in **ACTIVE** status ### What Happens * Form status changes from **ACTIVE** to… - [Archive a specific version of a form](https://developer.penneo.com/reference/post_v1-forms-externalid-archive-version.md): Archive (unpublish) a specific version of an active form. ### Requirements * The specified form version **MUST** be in **ACTIVE** status * Version number must exist for the given form ### What… - [Update specific form version](https://developer.penneo.com/reference/put_v1-forms-externalid-version.md): Update a specific version of a form with sections and input fields. ### Behavior * If the specified version is in **DRAFT** status: Updates the existing draft * If the specified version is… - [List files attached for given casefile](https://developer.penneo.com/reference/get_v1-casefiles-id-files.md) - [Restore a specific version of a form](https://developer.penneo.com/reference/post_v1-forms-externalid-restore-version.md): Restores a previous ARCHIVED version of a form to make it available for end-users. ### Requirements * Form version **MUST** be in **ARCHIVED** status * Version number must exist for the given form *… - [List submissions for a form](https://developer.penneo.com/reference/get_v1-forms-formid-submissions.md): Returns a paginated list of submissions for the given form. ### Requirements * The form **MUST** exist and the user must have access to it * Only completed submissions are included (i.e. those that… - [Get submitted user data for given submission](https://developer.penneo.com/reference/get_v1-forms-formid-submissions-submissionid-answers.md): Retrieve all submission data for a specific submission, identified by its external submission ID. ### Requirements * The form **MUST** exist and the user must have access to it * The submission… - [List forms](https://developer.penneo.com/reference/get_v1-forms.md): Retrieve a paginated list of all forms accessible to the logged-in user. ### What You Get * Forms created in the customer account * Only forms the user has access to (based on permissions) *… - [Download the signed document for a submission](https://developer.penneo.com/reference/get_v1-forms-formid-submissions-submissionid-signed-document.md): Streams the signed PDF document for a specific submission, identified by its external submission ID. ### Requirements * The form **MUST** exist and the user must have access to it * The submission…