Webform Monday.com
Creates a Webform handler that connects results to Monday.com via API integration.
Features
Webform Monday.com sends webform submissions to Monday.com boards as new items, using the Monday.com GraphQL API. Use it to feed contact forms, lead forms, registrations, or support requests directly into the boards your team already works in, no Zapier or Make subscription required.
- Multiple Monday.com accounts. Each account ("instance") is a configuration entity, so agencies and organizations working with several Monday.com workspaces can define them all and pick the right one per handler, or just set one site-wide default.
- Secure token storage via Key. API tokens live in Key entities, so they stay out of exported configuration and your git repository, and can be stored in environment variables, files, or any other Key provider.
- Per-element column mapping. A simple table maps each webform element to a Monday.com column ID. Values are sent as simple strings, which Monday.com accepts for most column types (text, numbers, status, date, email, phone…).
- Structured and fixed column values. A YAML area (with token support) covers fixed values and column types that need JSON objects, and can optionally create missing status/dropdown labels.
- Token support throughout: item name, board ID, group ID, and additional column values all accept tokens.
- Connection verification. Saving an instance runs a live test query and reports which Monday.com account it authenticated as.
- Resilient by design. API failures are logged to a dedicated channel and never block the visitor's submission. Handlers can fire on submission completion and/or update, and can be added multiple times per webform to target several boards or accounts.
Post-Installation
- Create a key at Configuration » System » Keys (
/admin/config/system/keys) containing a Monday.com API token. Tokens are created in Monday.com under your avatar » Developers » My access tokens. - Create an instance at Configuration » Web services » Monday.com (
/admin/config/services/monday) and select that key. The connection is verified when you save. - Optionally set a site-wide default instance, API version, request timeout, and debug logging on the Settings tab.
- On any webform, go to Settings » Emails / Handlers, add the Monday.com handler, and configure the board ID, item name, and column mapping. Column IDs are shown in Monday.com under the board menu » Developers » Column IDs.
The administer webform_monday permission controls access to instances and global settings.
Additional Requirements
- Webform 6.3+
- Key
- A Monday.com account with an API token (personal or app token with
boards:writescope)
No external PHP libraries are required; the module uses Drupal core's HTTP client.
Recommended modules/libraries
- Token: provides the token browser UI used on the handler form.
- Key providers such as environment variables or file-based keys, for keeping tokens out of the database on production.
Similar projects
Monday CRM Integration also relays webform submissions to Monday.com boards. It is intentionally minimal: a single Monday.com account, with the API token supplied through an environment variable, and all configuration on the handler itself. Choose Webform Monday.com if you need multiple Monday.com accounts, site-wide defaults, Key-based token management, structured/fixed column values, or Drupal 10 support.
Supporting this Module
Development is sponsored by Great Matter. Bug reports, feature requests, and merge requests are welcome in the issue queue.
Community Documentation
See the README in the module for detailed setup and column-mapping examples, including structured YAML values for date and email columns.