Basin

Learn how to use Basin with Composio

Overview

SLUG

BASIN

Description

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

Authentication Details

generic_api_key
stringRequired

Tools

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.

Action Parameters

name
stringRequired
notifications
object
project_id
integerRequired
redirect_url
string
spam_settings
object
timezone
stringRequired
use_ajax
boolean

Action Response

data
objectRequired
error
string
successful
booleanRequired

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.

Action Parameters

enabled
booleanDefaults to True
form_id
integerRequired
format
string
name
string
trigger_when_spam
boolean
url
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: BASIN_CREATE_NOTIFICATION

Tool to create a new notification webhook. use when you need to forward form submissions to an external service.

Action Parameters

enabled
booleanDefaults to True
form_id
integerRequired
format
stringRequired
name
stringRequired
trigger_when_spam
boolean
url
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

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

Action Parameters

name
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

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.

Action Parameters

form_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: BASIN_DELETE_INTEGRATION

Tool to delete a form webhook integration. use when removing an obsolete integration by id.

Action Parameters

integration_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

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.

Action Parameters

project_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

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.

Action Parameters

webhook_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: BASIN_GET_DOMAINS

Tool to retrieve a list of all domains associated with the account. use after authentication when you need to display or verify your configured domains in basin.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: BASIN_GET_FORMS

Tool to retrieve a list of all forms. use after authentication to fetch all your forms.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: BASIN_GET_FORM_DETAILS

Tool to retrieve detailed information about a specific form. use when you have a form id and need its metadata.

Action Parameters

form_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: BASIN_GET_PROJECTS

Tool to retrieve a list of all projects. use after authentication to fetch your project inventory.

Action Parameters

page
string
query
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

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

Action Parameters

project_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: BASIN_GET_SUBMISSIONS

Tool to retrieve all submissions for a specific form. use when you need to list entries after obtaining the form id.

Action Parameters

date_range
filter_by
string
form_id
string
order_by
string
query
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: BASIN_GET_WEBHOOKS

Tool to retrieve all webhooks associated with a specific form. use after obtaining the form id.

Action Parameters

form_id
integerRequired
page
integer
query
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: BASIN_UPDATE_INTEGRATION

Tool to update a form webhook integration. use to modify settings of an existing integration.

Action Parameters

enabled
boolean
form_id
integer
format
string
integration_id
integerRequired
name
string
trigger_when_spam
boolean
url
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

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

Action Parameters

name
stringRequired
project_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: BASIN_UPDATE_WEBHOOK

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

Action Parameters

enabled
boolean
form_id
integer
format
string
name
string
trigger_when_spam
boolean
url
string
webhook_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired