Search by

heano / craft-basin

peteheaney

Use Basin (usebasin.com) forms in Craft CMS, and view and manage their submissions from the Control Panel.

Package info

github.com/heanohq/craft-basin

Type:craft-plugin

pkg:composer/heano/craft-basin

Statistics

Installs: 1

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

1.0.0 2026-11-21 15:01 UTC

This package is auto-updated.

Last update: 2026-11-21 15:25:15 UTC


README

Your Basin forms, inside Craft.

Let Basin do the hard work of forms: blocking spam, sending notifications and storing uploads. Submissions go straight to Basin, so there's no mail setup and no personal data in your Craft database. You still read, manage and export every submission in the Control Panel, and each form gets the spam protection it needs automatically.

Features

  • Submissions in the Control Panel. Inbox, spam and trash for every form, with search, dates and bulk actions. Mark submissions as read or spam, move them to the trash, or send them to the form's webhooks again, without leaving Craft.
  • Create and edit forms. Create forms in your Basin project, change their notifications, redirect, auto-reply and retention, and delete them, from the Control Panel.
  • Spam protection, added for you. Whatever CAPTCHA and honeypot Basin requires for a form, the page gets it, even in hard-coded markup and cached templates. Works with reCAPTCHA v2 and v3, hCaptcha and Turnstile.
  • A Basin Form field. Let editors pick a form for an entry. It warns them if a form is no longer in your Basin project.
  • Form Studio forms. Add a Form Studio form's embed code once, then output it anywhere with one line of Twig.
  • CSV export and a dashboard widget. Export any view of your submissions, and see unread counts and the latest submissions on the dashboard.
  • Twig and GraphQL. Look up forms by their Basin ID in templates, or query them for a headless front end.
  • An error log. If a form is deleted or moved out of your project, it simply isn't shown on the site, and the Control Panel tells you where it was used.
  • Permissions. Choose who can see submissions, manage them, export them, and create, edit or delete forms. Permanently deleting submissions is off unless you turn it on.

Your markup, Basin's endpoint

Write the form however you like:

{% set form = craft.basin.form('demo0contact') %}
{% if form %}
    <form action="{{ form.action }}" method="post">
        <input type="email" name="email" required>
        <textarea name="message"></textarea>
        <button>Send</button>
    </form>
{% endif %}

Requirements

  • Craft CMS 5.0 or later
  • PHP 8.2 or later
  • A Basin account on the Growth plan or higher, which Basin needs for Account API keys

Installation

Install it from the Plugin Store in your Control Panel, or with Composer:

composer require heano/craft-basin
php craft plugin/install basin

Setup

  1. In Basin, go to Account → API and create an Account API key. Account API keys need Basin's Growth plan or higher.
  2. Add it to your .env file:
    BASIN_API_KEY="your-account-api-key"
  3. In Craft, go to Basin → Settings, enter $BASIN_API_KEY and click Test connection.
  4. Save, then choose the Basin project whose forms this site uses.

Every form in that project is now available to the site. Each environment can link its own project, such as a staging one.

Documentation

Everything else, from spam protection to GraphQL, is in the documentation.

Support

Found a bug or have a question? Open an issue.

Basin for Craft is made by heano. It isn't made by Basin.