Use an API token scoped for surveys.readonly to securely access survey data from the Workflows API. Store credentials securely and rotate them regularly.
In Rankr, configure a connected app with the Workflows API credentials. Use OAuth2 or API keys as supported, and grant the surveys.readonly scope for read access.
– GET /surveys/ — Retrieve all surveys – GET /surveys/submissions — Retrieve submissions for surveys
Triggered when a new survey is created or updated in Workflows API.
Sync survey data to Rankr contacts, update records, and trigger automations.
GET /surveys/
survey_id, title, created_at, updated_at
Triggered on new submissions or changes to existing ones.
Add submissions to Rankr as responses, create/update respondent profiles.
GET /surveys/submissions
submission_id, survey_id, respondent_id, submitted_at
Triggered by Workflows API events for real-time updates.
Forward events to Rankr automations; notify teams; sync records.
Webhooks via Rankr
event_id, event_type, payload
Automate survey data flows without custom coding.
Real-time data sync and up-to-the-minute reporting.
Centralized dashboards and faster decision making.
Key elements include endpoints, authentication, triggers, and data fields; processes describe data flow from Workflows API to Rankr.
A URL that represents a resource you can access via the API.
The method by which your app proves its identity to the API to gain access.
A way for the server to notify your app about events in real time.
The access permissions granted to your API key or OAuth token, like surveys.readonly.
Set Rankr to automatically email survey invitations when new surveys are created via Workflows API.
Push live survey results into Rankr dashboards for instant insights.
Trigger automated onboarding or nurture sequences based on survey responses.
Generate an API key or OAuth client in Workflows API and grant surveys.readonly scope.
Enter credentials in Rankr’s Integrations settings and test the connection.
Run a test sync, verify data flow, and enable scheduled automation.
The Workflows API is a secure interface that lets Rankr fetch survey data. It uses a scoped API token or OAuth credentials. You can connect Rankr to the Workflows API to pull surveys and submissions. Once connected, you can automate reporting and dashboards without writing code. This setup helps you maintain data accuracy and speed across systems without custom development.
You typically need a token with surveys.readonly scope. Permissions should be restricted to read access for compliance. If your data model requires, request broader scopes and ensure least privilege.
In Rankr, use the Test Connection feature in the Integrations area. Verify that calls to GET /surveys/ and GET /surveys/submissions return expected data.
Yes. Webhooks can notify Rankr of new submissions or updated surveys in real time. You can configure them in the Workflows API and subscribe in Rankr.
The documented endpoints typically include: GET /surveys/ and GET /surveys/submissions. Other endpoints may exist in your tenant.
No coding is required for basic integration. Rankr provides no-code connectors and automation builders to map data fields.
Rankr’s knowledge base, tutorials, and the Workflows API documentation provide detailed steps and examples.
Due to high volume, we will be upgrading our server soon!
Complete Operations Catalog - 126 Actions & Triggers
