Basin

These are the Basin actions available to the apps you build with Snow. Connecting an account does not make Snow run these on its own.

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

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

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