lindemannrock / craft-formie-rest-api
REST API for Formie - Provides REST endpoints for accessing Formie forms and submissions
Package info
github.com/LindemannRock/craft-formie-rest-api
Type:craft-plugin
pkg:composer/lindemannrock/craft-formie-rest-api
Requires
- php: ^8.2
- craftcms/cms: ^5.0.0
- guzzlehttp/guzzle: ^7.0
- lindemannrock/craft-logging-library: ^5.0
- lindemannrock/craft-plugin-base: ^5.0
- verbb/formie: ^3.0.0
Requires (Dev)
- craftcms/ecs: dev-main
- craftcms/phpstan: dev-main
- lindemannrock/craft-formie-rating-field: ^3.0
- phpunit/phpunit: ^11.0
README
Formie REST API Plugin
A REST API plugin for Craft CMS that exposes Formie forms and submissions through authenticated REST endpoints. Designed for external systems (e.g. SAP, BI tools, partner integrations) that need structured form data over HTTP.
Note on GraphQL: Formie ships with its own GraphQL schema at Craft's
/apiendpoint. This plugin does not add GraphQL — it adds a separate REST API with its own auth (X-API-Key), rate limiting, and access logging. If you want GraphQL, use Formie's built-in support directly.
License
This is a commercial plugin licensed under the Craft License. It will be available on the Craft Plugin Store soon. See LICENSE.md for details.
⚠️ Pre-Release
This plugin is in active development and not yet available on the Craft Plugin Store. Features and APIs may change before the initial public release.
Features
- REST endpoints — list and read Formie forms and submissions as JSON
- CP-managed API keys — one key per consumer, with per-key form scoping, submissions toggle, expiry, and an enable switch
- API-key authentication — via the
X-API-Keyheader - HMAC request signing — optional per key (replay + tamper protection)
- IP whitelist — optional per key (IPv4/IPv6 + CIDR)
- Rate limiting — per-key hourly budget with
X-RateLimit-*headers and429on exceed - Access logging — every request logged via the Logging Library
- In-CP test page — try endpoints and download a Postman collection without leaving Craft
- Translated CP UI — 12 languages
Requirements
- Craft CMS 5.0 or greater
- PHP 8.2 or greater
- Formie 3.0 or greater
Installation
Via Composer
composer require lindemannrock/craft-formie-rest-api
php craft plugin/install formie-rest-api
Using DDEV
ddev composer require lindemannrock/craft-formie-rest-api
ddev craft plugin/install formie-rest-api
Documentation
Full documentation is available in the docs folder.
Support
- Issues: GitHub Issues
- Email: support@lindemannrock.com
License
This plugin is licensed under the Craft License. See LICENSE.md for details.
Developed by LindemannRock
Built for use with Formie by Verbb
