Basin

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.

Common workflows with Basin

01

Trigger on event

  1. Listen for a new event
  2. Parse and validate the payload
  3. Take an action with the linked tool
02

Daily summary

  1. Pull yesterday's activity
  2. Summarise with the model of your choice
  3. Send the digest via email or Slack
03

Cross-tool sync

  1. Read records from one app
  2. Transform with a persona
  3. Write the result back via this integration

Basin actions 19

Every Basin action below is a callable tool any Definable persona can invoke.

Create Form

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.

Create Form Webhook

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.

Create Project

Tool to create a new Basin project. Use when you need a new organizational container for forms. Example: "Create a project named Marketing Leads."

Delete Form

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.

Delete Project

Tool to delete a project. Use when you need to remove a project after confirming its ID. Returns the deleted project's details.

Delete Submission

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.

Delete Webhook

Tool to delete a specific webhook. Use when you need to remove a webhook from a form after confirming its ID.

Get Domains

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.

Get Form Details

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).

Get Forms

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.

Get Form Webhook

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.

Get Project Details

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).

Get Projects

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.

Get 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.

Get Webhooks

Tool to retrieve all webhooks associated with a specific form. Use after obtaining the form ID.

List Form Views

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).

Update Form

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.

Update Project

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'".

Update Webhook

Tool to update settings of an existing webhook for a form. Use after obtaining the webhook's ID.

Frequently asked questions

What can I automate with Basin on Definable?

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.

How does Basin authentication work?

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.

Is the Basin integration included in my Definable plan?

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.

Is using Basin through Definable secure?

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.

How do I get started with Basin on Definable?

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.

What Basin actions does Definable expose?

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.

Ready to automate with Basin?

Wire it up in minutes. No coding required.

← All integrations