@@ -14,26 +14,44 @@ Required minimum versions of Umbraco CMS:
14
14
15
15
### Authentication
16
16
17
- The package uses the OAuth protocol for authentication.
17
+ The package uses the OAuth protocol for authentication or private access tokens (if you are using a private app installed on your HubSpot account) .
18
18
19
19
### Additional Configuration
20
20
21
- To support multi-region HubSpot forms, the following app setting is required in ` Web.config ` :
21
+ To support multi-region HubSpot forms, the following app settings are required:
22
+ - Umbraco 8 ` web.config ` :
22
23
```
23
24
<appSettings>
24
25
...
26
+ <add key="Umbraco.Cms.Integrations.Crm.Hubspot.ApiKey" value="[your_private_app_access_token]" />
25
27
<add key="Umbraco.Cms.Integrations.Crm.Hubspot.Region" value="[region]" />
26
28
...
27
29
</appSettings>
28
30
```
31
+ - Umbraco 9+ ` appsettings.json ` :
32
+ ```
33
+ "Integrations": {
34
+ "Crm": {
35
+ "Dynamics": {
36
+ "Settings": {
37
+ "ApiKey": "[your_private_app_access_token]",
38
+ "Region": "[region]"
39
+ }
40
+ }
41
+ }
42
+ }
43
+ ```
29
44
30
45
For example, in Europe, a setting of ` eu1 ` should be used.
31
46
32
47
### Backoffice usage
33
48
49
+ #### Note:
50
+ ** As of November 30, 2022, HubSpot API is accessible using a private app access token or OAuth.**
51
+
34
52
To use the form picker, a new data type should be created based on the HubSpot Form Picker property editor.
35
53
36
- The settings in ` Web.config ` will be checked and a message presented indicating whether authenticiation is in place.
54
+ The settings will be checked and a message presented indicating whether authenticiation is in place.
37
55
38
56
If OAuth is being used for authentication is available, then the _ Connect_ button will be enabled, prompting the user when clicked,
39
57
with the HubSpot authorization window.
@@ -42,6 +60,8 @@ The retrieved access token will be saved into the database and used for future r
42
60
43
61
_ Revoke_ action will remove the access token from the database and the authorization process will need to be repeated.
44
62
63
+ If a private access token is used a message will be displayed notifying that access token is being used.
64
+
45
65
### Front-end rendering
46
66
47
67
A strongly typed model will be generated by the property value converter, and an HTML helper is available, to easily render the form on the front-end.
0 commit comments