Formstack integration

What it does

The Formstack integration lets your agency operate a client's online forms without leaving TaskJuice. Connect a client's Formstack account once and you can list their forms, inspect a form's field schema, list and retrieve submissions, and create new submissions programmatically. Two triggers turn Formstack activity into workflow runs: a real-time webhook for each new submission, and a polling fallback for accounts where editing the webhook configuration is not an option.

Connect a Formstack account

1. Open your workspace in TaskJuice and navigate to Connections.
2. Choose Formstack and click Connect.
3. Sign in to Formstack as the user whose forms you want to manage, open My Account, and choose Personal Access Tokens.
4. Create a new token, copy it, and paste it into TaskJuice.
5. Save the connection. It is ready to use in any workflow that targets Formstack.

To rotate a token, sign in to Formstack, open My Account, choose Personal Access Tokens, revoke the existing token, and paste the new one into the same TaskJuice connection. Existing workflows pick up the new token on the next run.

Triggers

• formstack/new-submission fires when Formstack delivers a webhook for a new submission. Verified via the HMAC key configured on the form's webhook and signed with HMAC-SHA256 over the raw request body in the X-FS-Signature header.
• formstack/new-submission-polling polls the form's submissions endpoint on a fixed interval and emits one activation per new submission. Use this when the client cannot edit the form's Send Data to an External URL configuration.

Actions

• formstack/list-forms lists forms accessible to the connected user, with optional folder filtering and page-based pagination.
• formstack/get-form retrieves a single form's configuration and field schema by ID.
• formstack/list-submissions lists submissions for a form, with minTime and maxTime filtering, ascending or descending order, and page-based pagination.
• formstack/get-submission retrieves a single submission by ID, including its field values.
• formstack/create-submission creates a new submission on a form by posting an array of { fieldId, value } objects.

Known limitations

• Personal Access Tokens inherit the in-app permissions of the Formstack user that created them. To act on a client's forms, the connected token must belong to a user with access to those forms.
• Formstack returns 401 Unauthorized when a form has submission encryption enabled and no encryption password is supplied. The integration does not currently pass an X-FS-Encryption-Password header; use forms without encryption for the submissions actions, or fetch the submissions out of band.
• The new-submission webhook requires an HMAC key configured on the form (Settings, Emails and Redirects, Send Data to an External URL, HMAC Key). Without an HMAC key, the inbound POST cannot be verified and TaskJuice rejects it. Paste the same HMAC value into the trigger as the signing secret.
• Formstack only emits webhooks for form submissions. To react to other lifecycle changes, list or poll the relevant resource on a schedule.