Skip to main content

Documentation Index

Fetch the complete documentation index at: https://formhug.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

The FormHug API lets you manage forms, read submissions, configure webhooks, and submit entries on behalf of your users. It is a JSON REST API hosted at https://formhug.com.

​
Conventions

  • Base URL: https://formhug.com
  • Request and response keys are snake_case.
  • All responses are JSON. Successful responses wrap the payload in a data envelope; paginated lists add a pagination object.
  • Errors return a non-2xx status with { "error": "...", "error_details": [...] }. error_details only appears for model validation failures.

​
Successful response

{
  "data": { "id": "abc123", "name": "My form" }
}

​
Paginated response

{
  "data": [ /* items */ ],
  "pagination": { "total": 123, "next_cursor": "NQ==" }
}

​
Error response

{
  "error": "Name can't be blank",
  "error_details": [
    { "attribute": "name", "message": "can't be blank" }
  ]
}

​
Resources

ResourceWhat it covers
FormsCreate, update, list, and delete forms.
FoldersOrganize forms into folders.
EntriesRead submissions (private) and submit to a published form (public).
WebhooksSubscribe to events on a form’s submissions.
OAuthAuthorize third-party apps to act on a user’s behalf.
MeInformation about the authenticated user.

​
Next steps

  • Authentication — choose between OAuth tokens and Personal Access Tokens, understand scopes.
Last modified on May 13, 2026