Trigger on event
- Listen for a new event
- Parse and validate the payload
- Take an action with the linked tool
19 tools available
Basin is a no-code form backend that enables users to set up powerful, reliable forms quickly without writing server-side code.
Connect Basin to Definable to automate repetitive tasks, sync data with the rest of your stack, trigger on real-world events. Personas call Basin's 19 tools directly from chat or scheduled flows. You can wire it into any persona to read, write, and react when an event fires.
Every Basin action below is a callable tool any Definable persona can invoke.
Tool to create a new form in Basin. Use when you need to automate form setup with name, timezone, and project association; optionally configure redirect, notifications, or spam protection.
Tool to create a new webhook for a specific form. Use when you need to programmatically add a webhook once you have the form ID and callback URL confirmed.
Tool to create a new Basin project. Use when you need a new organizational container for forms. Example: "Create a project named Marketing Leads."
Tool to delete a form. Use when permanently removing a form after it's no longer needed. Ensure the form_id is correct; this operation is irreversible.
Tool to delete a project. Use when you need to remove a project after confirming its ID. Returns the deleted project's details.
Tool to permanently delete a form submission by its ID. Use when you need to remove a submission after confirming its ID. This operation is irreversible.
Tool to delete a specific webhook. Use when you need to remove a webhook from a form after confirming its ID.
Tool to retrieve a list of all custom domains associated with the Basin account. Custom domains allow you to send emails from your own domain through Basin forms. Supports pagination and filtering by domain name or ID.
Retrieves comprehensive details about a specific Basin form including configuration, notification settings, security options, branding, webhooks, and submission counts. Use this when you need complete information about a form's setup and current state. Requires a form ID (obtain from Get Forms action if needed).
Retrieves a list of all Basin forms with their configuration and metadata. Supports optional pagination via the 'page' parameter and filtering via the 'query' parameter (searches across form id, name, uuid, and project_id). Returns comprehensive form details including webhooks, submission counts, notification settings, and security configurations.
Tool to retrieve details of a specific form webhook by its ID. Use when you need to view webhook configuration including URL, format, and trigger settings.
Tool to retrieve detailed information about a specific project. Use when you have a project ID and need its metadata (name, created_at, updated_at).
Retrieves a list of Basin projects from your account. Returns project details including IDs, names, and timestamps. Use this to list all projects or filter by name/ID. The response includes pagination metadata to help navigate large result sets. Typical use: Get project IDs for use with other project-specific endpoints like forms or submissions.
Retrieve form submissions from Basin with optional filtering, sorting, and search capabilities. Can retrieve all submissions across forms or filter by specific form_id. Supports filtering by status (new/spam/trash/all), text search, date range, and sorting by date or email.
Tool to retrieve all webhooks associated with a specific form. Use after obtaining the form ID.
Retrieves a list of all Basin form views with their configuration and metadata. Supports optional pagination via the 'page' parameter and filtering via the 'query' parameter (searches across form view id, uuid, form id, and form uuid).
Tool to update an existing Basin form by ID. Use when you need to modify form settings including name, notifications, spam protection, redirects, or other configuration options.
Tool to update details of an existing project. Use when you need to change a project's name after confirming the project ID. Example: "Update project 123 to 'Rebrand Launch'".
Tool to update settings of an existing webhook for a form. Use after obtaining the webhook's ID.
Anything Basin exposes through its API. Common forms & surveys workflows on Definable include automate repetitive tasks, sync data with the rest of your stack, trigger on real-world events. Personas can call any of the 19 Basin tools directly, then chain the result into another integration without you writing code.
Basin uses API_KEY on Definable. You connect once from the integrations page, scoped to the permissions you choose, and from then on any persona that has the integration enabled can act on your behalf. Tokens are encrypted at rest and rotated automatically.
Yes — every Definable plan, including Starter, includes access to all 19 Basin tools. You only need a separate Basin subscription if Basin itself charges per seat or per API call.
Every call from a persona to Basin is logged with the user, persona, prompt, and response. Tokens never leave Definable's secrets vault, scopes are configurable per persona, and you can revoke access at any time from the integration page.
Sign up for Definable, open the integrations page, find Basin, and connect via OAuth or API key. You can immediately attach Basin to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.
Definable exposes all 19 Basin actions as callable tools — including `Create Form`, `Create Form Webhook`, `Create Project`, plus 16 more. Each tool gets a typed parameter schema so personas know exactly how to call it.
Wire it up in minutes. No coding required.