Authenticate Yay! Forms to access your Workflows API data by generating an API key with the surveys.readonly scope and storing it securely.
To connect Yay! Forms to Workflows API, create an API key in your Workflows API dashboard with the required scope (surveys.readonly) and enter it in the connector settings.
– GET /surveys/ — fetch surveys – GET /surveys/submissions — fetch submissions – (Upcoming) additional endpoints will be documented as they become available.
Trigger: When Yay! Forms loads, fetch the latest surveys from the Workflows API to populate options.
Actions: Map survey IDs to form fields and display survey titles for selection.
GET /surveys/
survey_id, title, fields
Trigger: When a user completes a Yay! Forms survey, push the submission to /surveys/submissions.
Actions: Create or update submission records and link to the corresponding survey.
POST /surveys/submissions
survey_id, submission_id, answers
Trigger: New submissions push data to your analytics dashboards.
Actions: Update dashboards, trigger automations based on responses.
GET /surveys/submissions
submission_id, timestamp
Automate survey data flow without writing code
Quick setup with a visual connector and ready-made endpoints
Scales across teams with centralized data
Overview of elements and processes: API endpoints, authentication, data mapping, triggers, actions.
A specific URL path in the Workflows API that enables a particular operation, such as retrieving surveys.
Methods used to verify identity and authorize access to the Workflows API, such as API keys and tokens.
A callback mechanism to notify Yay! Forms of events in the Workflows API.
A connection between Yay! Forms and the Workflows API that enables data exchange.
Automatically pull surveys to prefill Yay! Forms before the user begins.
Map responses to Workflows API submissions and trigger downstream automations.
Display live submission data in dashboards and reports.
Create an API key in your Workflows API dashboard with the required scope (surveys.readonly) and copy it to Yay! Forms.
Enter the API key, map endpoints, and specify triggers and field mappings.
Run tests by fetching surveys and submitting a test response to confirm data flows correctly.
The Workflows API exposes surveys and submissions data that you can fetch from Yay! Forms. You can access survey definitions, titles, and questions, as well as user submissions. With the surveys.readonly scope, you can safely read data and populate forms, trigger automations, and generate reports.
No code is required if you use the Yay! Forms connector for the Workflows API. The setup guides you through authentication and field mapping. For advanced needs, you can still extend the integration with minimal scripting, but most use cases are achievable without code.
Authentication is typically done with an API key that includes restricted scopes (e.g., surveys.readonly). Securely store the key and rotate it periodically; consider environment variables or a secrets manager.
The key endpoints are GET /surveys/ to list surveys and GET /surveys/submissions to fetch responses. Other endpoints may be available in the future; check the API docs for updates.
If you encounter errors, check the HTTP status codes, verify your API key and scopes, and review response messages. Respect rate limits, implement exponential backoff, and consult logs or support if needed.
Real-time syncing depends on available webhooks or polling schedules. Use polling if webhooks are not available. In Yay! Forms, configure triggers to pull new submissions at defined intervals and update dashboards.
Test the integration by running a test survey in Workflows API and submitting test responses through Yay! Forms. Review connector logs and verify data appears in your reports.
Due to high volume, we will be upgrading our server soon!
Complete Operations Catalog - 126 Actions & Triggers
