API Reference

​

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

​

Next steps

• Authentication — choose between OAuth tokens and Personal Access Tokens, understand scopes.