Zapier with Umbraco Forms

Details an integration available for Zapier with Umbraco Forms, built and maintained by Umbraco HQ.

This integration is an add-on to the Zapier CMS integration and provides necessary components for handling form submissions based on the registered subscription hooks.

A Zap is an automated workflow that connects apps and services together. Each Zap consists of a trigger and one or more actions.

Package Links

• NuGet install

• Source code

• Umbraco marketplace listing

Minimum version requirements

Umbraco CMS

Major	Minor/Patch
Version 8	8.1.0
Version 10	10.1.0
Version 11	11.0.0

Umbraco Forms

Major	Minor/Patch
Version 8	8.9.1
Version 10	10.1.0
Version 11	11.0.0

Authentication

For this integration, the authentication is managed on Zapier's side by using the Umbraco Marketplace app.

The Umbraco app manages two types of events:

• New Form Submission - triggers when a form is submitted.

• New Content Published - triggers when new content has been published.

The trigger event to be used by this integration is New Form Submission.

When creating the Zap trigger, you will be prompted to enter a username, password, and URL for your Umbraco website.

It is also possible to use an API key. If the following setting is present, the API key-based authentication will take precedence and will be used for authorization.

Versions 9 and above

appsettings.json

"Umbraco": {
  "Forms": {
    "Integrations": {
      "Automation": {
        "Zapier": {
          "Settings": {
            "ApiKey": "[your_api_key]"
          }
        }
      }
    }
  }
}

Version 8

web.config

<appSettings>
...
  <add key="Umbraco.Forms.Integrations.Automation.Zapier.ApiKey" value="[your_api_key]" />
...
</appSettings>

If no API key is present, the Umbraco application will validate the credentials entered and return a message in case the validation fails.

To enhance security, you can specify a User Group that the user connecting needs to be a part of. This can be achieved by adding the following setting to the configuration file:

Version 9 and above

appsettings.json

"Umbraco": {
  "Forms": {
    "Integrations": {
      "Automation": {
        "Zapier": {
          "Settings": {
            "UserGroup": "[your_user_group]"
          }
        }
      }
    }
  }
}

Version 8

web.config

<appSettings>
  <add key="Umbraco.Forms.Integrations.Automation.Zapier.UserGroup" value="[your_user_group]" />
</appSettings>