Skip to main content
The HoopAI Platform Forms REST API gives you programmatic access to every aspect of lead capture form management. Retrieve form configurations and paginated submission data, look up individual submissions, upload files to custom fields, schedule CSV exports, verify emails and phone numbers, and manage form categories and themes — all without leaving your integration.

​
Base URL

https://services.leadconnectorhq.com

​
Authentication

Every request requires a Bearer token and an API version header. 
Authorization: Bearer <access_token>
Version: 2021-07-28
Use an access token generated with user type Sub-Account, or a Private Integration Token from a Sub-Account. See OAuth 2.0 for details.

​
OAuth scopes

ScopeAccess granted
forms.readonlyRead forms and form submissions
forms.writeUpload files to custom fields

​
Quick start

List all forms for a location: 
curl -X GET "https://services.leadconnectorhq.com/forms/?locationId=<locationId>&productType=form&limit=20&skip=0" \
  -H "Authorization: Bearer <access_token>" \
  -H "Version: 2021-07-28"

​
Endpoints

MethodPathDescription
GET/forms/Get forms
GET/forms/submissionsGet forms submissions
GET/forms/multiple-forms-submissionsGet submissions from multiple forms
GET/forms/submission/{submissionId}Get submission by ID
GET/forms/submission-details/{submissionId}Get submission details (open endpoint)
GET/forms/check-fb-lead-submissionCheck Facebook lead submission
GET/forms/forms-listGet forms by IDs
POST/forms/restore-versionRestore a form version
GET/forms/widget/linkGet widget link
POST/forms/imageAdd image in storage
POST/forms/upload-custom-filesUpload files to custom fields
POST/forms/schedule-form-exportSchedule form submission export as CSV
POST/forms/verify-emailVerify email
POST/forms/verify-phoneVerify phone
POST/forms/form-survey-eventFire form survey event
GET/forms/graph/dataGet form/survey stats graph data
GET/forms/stats/countGet form/survey stats count
GET/forms/stats/listGet form/survey stats list
POST/forms/clone-from-themeClone form from theme
GET/forms/theme-style/{themeId}Get theme style
POST/forms/{formId}/submissions/{submissionId}/download-pdfInitiate PDF download for submission
GET/forms/{formId}/submissions/{submissionId}/pdf-urlGet PDF URL for submission
GET/forms/snapshots/listGet form/quiz snapshot list
POST/forms/snapshots/check-conflictsCheck snapshot conflicts
POST/forms/snapshots/load-snapshotLoad a form snapshot
GET/forms/categories/get-categoriesGet all categories
GET/forms/categories/get-category/{categoryId}Get category by ID
GET/forms/categories/get-themes/{categoryId}Get themes by category
DELETE/forms/categories/delete-category/{categoryId}Delete category by ID
Last modified on March 4, 2026