knack-zapier v2.4.7

Knack Zapier

This is Knack's Zapier App, it allows for communication between Knack and other integration Apps provided on Zapier's platform.

Setup

• Install the Zapier CLI by running npm install -g zapier-platform-cli
• Run zapier login and enter your account credentials
• Clone this repository and npm install
• You can run zapier test to build and see if the application passes Zapier's validation criteria and our automated tests
• If pushing a new version bump the version in package.json (e.g. 1.0.0 -> 1.0.1)
  • The push will fail if it's a current production version with at least five users
• Run zapier push to build and push the app to Zapier's platform
  • It's a private version by default, refer to the QA / Staging section below to add developers/testers
• When the new version has been tested run zapier promote X.Y.Z to make it publicly visible for all new Zaps
• Optionally run zapier migrate A.B.C X.Y.Z to migrate all old users to the new version if all changes are backwards compatible
• Knack Zapier Integration Wiki

Local Testing With Ngrok

First step is to make sure Server / API is running on your machine and then:

• Run npm install -g ngrok && ngrok authtoken your_auth_token_here
• We no longer have a static ngrok hostname. It should be straight-forward to set up one for free at ngrok.com
• Run ngrok http --host-header rewrite --hostname={YourNgrokHostname} us-api.knackdev.com:3000
• When setting up your Zap put {YourNgrokHostname} as your Private Server Domain and local app credentials from your devenv for app-id and rest-api-key

Adding developers / testers

To add someone to the application:

• Go to https://developer.zapier.com/app/3615/team/members
• Click on Invite Team Member and add users
• Anyone with a knack.com email address can join our integration as a Collaborator on their own, without waiting for an invitation.