# Basin

Basin is a no-code form backend that enables users to set up powerful, reliable forms quickly without writing server-side code.

- **Category:** forms & surveys
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 19
- **Triggers:** 0
- **Slug:** `BASIN`
- **Version:** 20260506_00

## Tools

### Create Form

**Slug:** `BASIN_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

**Slug:** `BASIN_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

**Slug:** `BASIN_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

**Slug:** `BASIN_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

**Slug:** `BASIN_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

**Slug:** `BASIN_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

**Slug:** `BASIN_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

**Slug:** `BASIN_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

**Slug:** `BASIN_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

**Slug:** `BASIN_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

**Slug:** `BASIN_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

**Slug:** `BASIN_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

**Slug:** `BASIN_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

**Slug:** `BASIN_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

**Slug:** `BASIN_GET_WEBHOOKS`

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

### List Form Views

**Slug:** `BASIN_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

**Slug:** `BASIN_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

**Slug:** `BASIN_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

**Slug:** `BASIN_UPDATE_WEBHOOK`

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