Basin

Basin integration (Productivity, Marketing). Imported from open-connector.

API key18 toolshttps://usebasin.com

GET

basin_list_projects

List projects available to the current Basin API key.

/api/v1/projects

2 parameters

Param	Type	Required	Description
page	integer	optional	Page number to request from Basin.
query	string	optional	Search query accepted by the Basin list endpoint.

GET

basin_get_project

Fetch a single Basin project by ID.

/api/v1/projects/{project_id}

1 parameter

Param	Type	Required	Description
project_id	integer	required	Basin project ID.

POST

basin_create_project

Create a new Basin project.

/api/v1/projects/

1 parameter

Param	Type	Required	Description
name	string	optional	Project name.

PUT

basin_update_project

Update an existing Basin project by ID.

/api/v1/projects/{project_id}

2 parameters

Param	Type	Required	Description
project_id	integer	required	Basin project ID.
name	string	optional	Project name.

DELETE

basin_delete_project

Delete a Basin project by ID.

/api/v1/projects/{project_id}

1 parameter

Param	Type	Required	Description
project_id	integer	required	Basin project ID.

GET

basin_list_forms

List forms available to the current Basin API key.

/api/v1/forms

2 parameters

Param	Type	Required	Description
page	integer	optional	Page number to request from Basin.
query	string	optional	Search query accepted by the Basin list endpoint.

GET

basin_get_form

Fetch a single Basin form by ID.

/api/v1/forms/{form_id}

1 parameter

Param	Type	Required	Description
form_id	string	required	Basin form ID.

POST

basin_create_form

Create a new Basin form.

/api/v1/forms/

27 parameters

Param	Type	Required	Description
name	string	required	Form name.
timezone	string	required	IANA timezone used for form timestamps.
project_id	integer	required	Basin project ID.
redirect_url	string	optional	URL to redirect users to after submission.
use_ajax	boolean	optional	Whether the form should submit via AJAX.
notification_emails	string	optional	Comma-separated email addresses notified for each submission.
notification_cc_emails	string	optional	Comma-separated CC email addresses for submission notifications.
notification_bcc_emails	string	optional	Comma-separated BCC email addresses for submission notifications.
notification_subject	string	optional	Subject for submission notification emails.
notification_from_name	string	optional	From name for submission notification emails.
autoreply	boolean	optional	Whether Basin should send auto-reply emails.
autoreply_body	string	optional	Body text for auto-reply emails.
autoreply_subject	string	optional	Subject for auto-reply emails.
autoreply_from_name	string	optional	From name for auto-reply emails.
autoreply_greeting	string	optional	Greeting text for auto-reply emails.
autoreply_name	string	optional	Sender display name for auto-reply emails.
autoreply_title	string	optional	Title text for auto-reply emails.
autoreply_email	string	optional	Reply-to email address for auto-reply emails.
force_recaptcha	boolean	optional	Whether Google reCAPTCHA is required.
force_hcaptcha	boolean	optional	Whether hCaptcha is required.
force_turnstile	boolean	optional	Whether Cloudflare Turnstile is required.
honeypot_field	string	optional	Honeypot field name used for spam filtering.
retention_days	integer	optional	Number of days to retain form submissions.
allowed_domains	array	optional	Domains allowed to submit the form.
blocked_domains	array	optional	Domains blocked from submitting the form.
duplicate_filter	boolean	optional	Whether Basin should filter duplicate submissions.
smtp_email_validation	boolean	optional	Whether SMTP email validation is enabled.

PUT

basin_update_form

Update an existing Basin form by ID.

/api/v1/forms/{form_id}

28 parameters

Param	Type	Required	Description
form_id	string	required	Basin form ID.
name	string	optional	Form name.
timezone	string	optional	IANA timezone used for form timestamps.
project_id	integer	optional	Basin project ID.
redirect_url	string	optional	URL to redirect users to after submission.
use_ajax	boolean	optional	Whether the form should submit via AJAX.
notification_emails	string	optional	Comma-separated email addresses notified for each submission.
notification_cc_emails	string	optional	Comma-separated CC email addresses for submission notifications.
notification_bcc_emails	string	optional	Comma-separated BCC email addresses for submission notifications.
notification_subject	string	optional	Subject for submission notification emails.
notification_from_name	string	optional	From name for submission notification emails.
autoreply	boolean	optional	Whether Basin should send auto-reply emails.
autoreply_body	string	optional	Body text for auto-reply emails.
autoreply_subject	string	optional	Subject for auto-reply emails.
autoreply_from_name	string	optional	From name for auto-reply emails.
autoreply_greeting	string	optional	Greeting text for auto-reply emails.
autoreply_name	string	optional	Sender display name for auto-reply emails.
autoreply_title	string	optional	Title text for auto-reply emails.
autoreply_email	string	optional	Reply-to email address for auto-reply emails.
force_recaptcha	boolean	optional	Whether Google reCAPTCHA is required.
force_hcaptcha	boolean	optional	Whether hCaptcha is required.
force_turnstile	boolean	optional	Whether Cloudflare Turnstile is required.
honeypot_field	string	optional	Honeypot field name used for spam filtering.
retention_days	integer	optional	Number of days to retain form submissions.
allowed_domains	array	optional	Domains allowed to submit the form.
blocked_domains	array	optional	Domains blocked from submitting the form.
duplicate_filter	boolean	optional	Whether Basin should filter duplicate submissions.
smtp_email_validation	boolean	optional	Whether SMTP email validation is enabled.

DELETE

basin_delete_form

Delete a Basin form by ID.

/api/v1/forms/{form_id}

1 parameter

Param	Type	Required	Description
form_id	string	required	Basin form ID.

GET

basin_list_submissions

List Basin form submissions with optional filters.

/api/v1/submissions/

5 parameters

Param	Type	Required	Description
form_id	string	optional	Basin form ID used to filter submissions.
filter_by	string	optional	Submission status filter accepted by Basin.
query	string	optional	Search text for matching submissions.
order_by	string	optional	Submission sort order accepted by Basin.
date_range	string	optional	Date range in YYYY-MM-DD+to+YYYY-MM-DD format accepted by Basin.

GET

basin_get_submission

Fetch a single Basin submission by ID.

/api/v1/submissions/{submission_id}

1 parameter

Param	Type	Required	Description
submission_id	integer	required	Basin submission ID.

DELETE

basin_delete_submission

Delete a Basin submission by ID.

/api/v1/submissions/{submission_id}

1 parameter

Param	Type	Required	Description
submission_id	integer	required	Basin submission ID.

GET

basin_list_form_webhooks

List Basin form webhooks with optional filters.

/api/v1/form_webhooks

2 parameters

Param	Type	Required	Description
page	integer	optional	Page number to request from Basin.
query	string	optional	Search query accepted by the Basin list endpoint.

GET

basin_get_form_webhook

Fetch a single Basin form webhook by ID.

/api/v1/form_webhooks/{webhook_id}

1 parameter

Param	Type	Required	Description
webhook_id	integer	required	Basin form webhook ID.

POST

basin_create_form_webhook

Create a new Basin form webhook.

/api/v1/form_webhooks/

6 parameters

Param	Type	Required	Description
form_id	integer	required	Basin form ID to attach the webhook to.
name	string	required	Friendly webhook name.
url	string	required	Destination URL where Basin posts submission payloads.
format	string	optional	Webhook payload format accepted by Basin.
enabled	boolean	optional	Whether the webhook is enabled.
trigger_when_spam	boolean	optional	Whether the webhook fires for spam submissions.

PUT

basin_update_form_webhook

Update an existing Basin form webhook by ID.

/api/v1/form_webhooks/{webhook_id}

7 parameters

Param	Type	Required	Description
webhook_id	integer	required	Basin form webhook ID.
form_id	integer	optional	Basin form ID to attach the webhook to.
name	string	optional	Friendly webhook name.
url	string	optional	Destination URL where Basin posts submission payloads.
format	string	optional	Webhook payload format accepted by Basin.
enabled	boolean	optional	Whether the webhook is enabled.
trigger_when_spam	boolean	optional	Whether the webhook fires for spam submissions.

DELETE

basin_delete_form_webhook

Delete a Basin form webhook by ID.

/api/v1/form_webhooks/{webhook_id}

1 parameter

Param	Type	Required	Description
webhook_id	integer	required	Basin form webhook ID.