Help Scout

The Help Scout addon needs to be installed and activated to see the features mentioned in this this documentation.

Connecting Ninja Forms to Helpscout

Login to you Help Scout account, then navigate to Your Profile > My Apps.

image of help scout account screen with user image highlighted in top right image of help scout account screen with options revealed by clicking the user image highlighted in top rightimage of help scout account screen with profile options highlighted in top right

 

Click “Create My App”, give the app a descriptive name and set the Redirect URL to: https://oauth.ninjaforms.com/authcode

image of help scout Manage api screen create my app highlighted image of help scout Manage api screen create my app button highlighted

 

Your newly created app will display an App Id and App Secret.  Copy and paste these as the Client Id and Client Secret in your Helpscout section of the Ninja Forms Settings page.  Click the button “Click to begin/restart authorization…”

image of help scout api screen with api keys highlightedimage of help scout api screen with secret keys highlighted

 

You will be directed to your Helpscout account, where you will be asked to authorize access to your account.  Please click “Authorize.”

You will be redirected to a secure Ninja Forms page displaying an authorization code.  Copy this code and paste in the Authorization Code text box in the Helpscout section of the Ninja Forms Settings page.  Then click the button “Generate Access using Authorization Code”

image of help scout api screen with auth keys highlighted

You will now see a refresh token and access token appear in your Helpscout settings section.  These codes will provide access to your account and re-generate approval automatically for your continued use.

 

Mapping Your Form Fields to Help Scout

To add the action to any form, from the Emails & Actions tab click Add New Action and then the Help Scout action from inside the Actions Window that opens.

image of the Emails and Actions tab of the form builder with Add New action and the help scout action highlighted within the actions window

 

Click to open the action itself, then select the desired Help Scout List from the dropdown menu.

image of the help scout action settings window with List options highlighted

Under List Field Mapping, use the Merge Tag icons pictured below to select the Ninja Forms field you want to map to the Help Scout field listed in this section.

image of the help scout action settings window with merge tag options highlighted

Troubleshooting

If you have any issues connecting Ninja Forms, enable Debug Mode under the Advanced options of the Help Scout action. Debug Mode will return error log data that can be copied and pasted into your support ticket.

image of the help scout action settings window with Advanced options highlighted

Tutorials & Blog Articles