Use OAuth 2.0 with a read-only scope to securely access installed locations and manage your SaaS subscriptions from 123FormBuilder.
Grant 123FormBuilder permission to access your SaaS API data. Ensure the user consents to the requested scopes (readonly) and follows the consent flow.
Endpoints used in this integration include: GET /oauth/installedLocations to fetch your installed locations; POST /oauth/locationToken to exchange credentials for a location token; saas/location.write to update location data; PUT /update-saas-subscription/:locationId to modify subscriptions; POST /enable-saas/:locationId to enable SaaS features.
Trigger: When a new location is created in SaaS API, automatically create a corresponding workspace in 123FormBuilder.
Actions: Create/update forms, sync metadata, and map fields between SaaS API and 123FormBuilder.
Method Path: GET /oauth/installedLocations to detect locations; POST /oauth/locationToken to obtain tokens; saas/location.write to push updates.
Key fields: locationId, locationName, status, subscriptionTier
Trigger: Subscription changes in SaaS API trigger updates in 123FormBuilder.
Actions: Update forms, adjust access, send notifications.
Method Path: PUT /update-saas-subscription/:locationId
Key fields: locationId, subscriptionStatus, renewalDate
Trigger: A user enables SaaS features from 123FormBuilder.
Actions: Call enable endpoint, update UI, log event.
Method Path: POST /enable-saas/:locationId
Key fields: locationId, featureFlag, enabledAt
Automate data flow between SaaS API and 123FormBuilder without writing code, using visual workflows.
Speed up onboarding by syncing locations and subscriptions automatically rather than manual exports.
Easily scale: add more endpoints and mapping as needs grow without custom development.
A quick glossary of terms used in this integration and how the parts fit together.
An authorization framework that enables apps to access data securely on behalf of a user.
A specific URL path that performs an action or returns data when called with appropriate methods and authentication.
Permissions that define what data and actions an app can access in a given API.
A SaaS account unit representing a distinct entity (e.g., a business location) within an integration.
Use the API to trigger a form submission workflow in 123FormBuilder whenever a new location is added in SaaS API.
Keep forms and reports up to date with the latest subscription status from SaaS API.
Allow non-technical users to enable/disable features via a simple form, which calls the enable endpoint.
Create OAuth credentials, authorize 123FormBuilder, and exchange authorization codes for tokens.
Select endpoints, authenticate requests, and map SaaS fields to 123FormBuilder fields.
Run tests, verify data sync, and enable automatic runs in production.
No coding is required to set up the basic SaaS API to 123FormBuilder connection. The platform provides a no-code workflow builder and pre-built actions. For advanced needs, custom fields mapping is supported.
OAuth scopes control access. For this integration, oauth.readonly is used to fetch data while ensuring secure read access. If write operations are needed, additional scopes would be requested during app authorization.
Endpoints include GET /oauth/installedLocations, POST /oauth/locationToken, saas/location.write, PUT /update-saas-subscription/:locationId, and POST /enable-saas/:locationId. Use them per the mapping described above.
To test, run a sandbox or staging environment; verify token exchange works; confirm that a new SaaS location creates a corresponding entity in 123FormBuilder; check data is flowing correctly.
Yes. Use the enable endpoint to toggle features on demand, allowing you to schedule activations.
There is typically a limit set by your plan and the API’s rate limits. In most cases, you can sync multiple locations; contact support for higher limits.
API credentials are found in your SaaS API developer dashboard. Copy the client ID and secret, then configure them in the 123FormBuilder integration screen.
Due to high volume, we will be upgrading our server soon!
Complete Operations Catalog - 126 Actions & Triggers
