Minform · Pipedream API

Pipedream integrationAPI reference

Minform API for Pipedream

Endpoints used by the Minform + Pipedream integration: OAuth, list forms, pull sample submissions, and REST-hook delivery on new responses.

Base URL

All Pipedream API routes live under:

https://minform.io/api/pipedream

OAuth authorize UI and token endpoints are under https://minform.io (not under /api/pipedream). Use HTTPS only.

How it fits together

  1. User authorizes via OAuth; Pipedream receives an access token (JWT) and refresh token.
  2. GET /forms populates the form dropdown.
  3. POST /hooks registers Pipedream's HTTP endpoint for submission.created.
  4. GET /results supplies sample records during source setup.
  5. On each new submission, Minform POSTs a one-element JSON array to the hook URL.

Endpoints

Authentication

OAuth 2.0

Authorization code flow; tokens via /api/oauth/token.

https://minform.io/oauth/authorizeView documentation →

Me

GET

Current user, scopes, and workspaces for the access token.

https://minform.io/api/pipedream/meView documentation →

Forms

GET

List forms the user can access (for dynamic form pickers).

https://minform.io/api/pipedream/formsView documentation →

Submissions (sample)

GET

Last 10 submissions for setup / sample data. Not a poll feed.

https://minform.io/api/pipedream/results?slug={form_slug}View documentation →

Webhooks

POST / DELETE

Subscribe to new submissions; live events are pushed, not polled.

https://minform.io/api/pipedream/hooksView documentation →

Scopes

ScopeUsed by
read:formsList forms
read:submissionsSample submissions + webhook subscribe

Both scopes are granted on authorize. Access tokens are JWTs that include a pipedream claim and are only valid on /api/pipedream/*.

Support

Questions about this integration: support@minform.io