Skip to content

Commit 5774447

Browse files
authored
Create readme.md
1 parent c53e808 commit 5774447

File tree

1 file changed

+39
-0
lines changed
  • src/Umbraco.Forms.Integrations.Automation.Zapier

1 file changed

+39
-0
lines changed
Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,39 @@
1+
# Umbraco.Forms.Integrations.Automation.Zapier
2+
3+
This integration provides a custom workflow, allowing form entries to be mapped to the fields of a Zap tool trigger from Zapier.
4+
5+
A Zap is an automated workflow that connects various apps and services together. Each Zap consists of a trigger and one or more actions.
6+
7+
## Prerequisites
8+
9+
Requires minimum versions of Umbraco:
10+
11+
- CMS: 8.1.0
12+
- Forms: 8.9.1
13+
14+
## How To Use
15+
16+
### Authentication
17+
18+
For this integration, the authentication is managed on Zapier's side.
19+
20+
When creating a Zap trigger, you will be prompted to enter a username, password and the URL for your Umbraco website.
21+
22+
Then the Umbraco application existing in the Zapier marketplace will validate the credentials entered and return a message in case the validation fails.
23+
24+
If you want to extend the security layer, you can also specify a user group that the user trying to connect needs to be a part of, by adding the following
25+
setting in `Web.config`:
26+
27+
```
28+
<appSettings>
29+
...
30+
<add key="Umbraco.Cms.Integrations.Automation.Zapier.UserGroup" value="[your User Group]" />
31+
...
32+
</appSettings>
33+
```
34+
35+
### Working With the Zapier Forms Integration
36+
Add the _Trigger Zap_ workflow to a form and configure which fields will be sent to the Zap.
37+
38+
You can add mappings for each of the form's fields (if no mapping is created, all fields will be included by default), and also pick one of the
39+
standard fields: Form ID, Form Name, Page URL, Submission date/time.

0 commit comments

Comments
 (0)