To connect Surveys API with Rankr, request an access token with the scope socialplanner/post.write. Use OAuth 2.0 or an API key as provided by the API provider, and store credentials securely.
Rankr will securely manage tokens and client credentials. Use the app’s credentials to authorize requests to the Surveys API.
– POST /social-media-posting/:locationId/posts — Create a new post – PUT /social-media-posting/:locationId/posts/:id — Update an existing post – DELETE /social-media-posting/:locationId/posts/:id — Delete a post – PATCH /social-media-posting/:locationId/posts/:id — Partially update a post
Trigger: a new survey response is recorded or a scheduled event fires.
Actions: create a social post using POST; include survey data like summary and insights.
POST /social-media-posting/:locationId/posts
locationId, content, surveyId, authorName
Trigger: survey results are updated or re-scored.
Actions: update the existing post with PUT by id, refreshing content.
PUT /social-media-posting/:locationId/posts/:id
locationId, id, content, status
Trigger: post is outdated or flagged for removal.
Actions: delete a post by id using DELETE.
DELETE /social-media-posting/:locationId/posts/:id
locationId, id
Automate workflows without writing code through built-in connectors and templates.
Sync survey results directly into social posts to save time and reduce manual work.
Scale campaigns with consistent templates and real-time data.
This glossary defines API terms and the steps to connect endpoints, authenticate, map data, and automate posts.
An Application Programming Interface that lets Rankr and the Surveys API talk to each other securely.
A request to create or publish a new social media item via the API.
A specific context for a location or social account within the API.
Credential used to authorize API requests to Surveys API.
Create posts triggered by new survey results, with dynamic content and brand-consistent language.
Publish weekly digests aggregating survey insights into a social post series.
Reuse templates to accelerate posting while maintaining tone and voice.
Obtain API keys, set scope to socialplanner/post.write, and test connectivity in a sandbox.
Map survey fields to post content and establish locationId context for endpoints.
Run tests, confirm data flow, and deploy with monitoring and logging.
No coding is required for most basic uses. Rankr provides connectors and templates that call the Surveys API endpoints directly. If you need complex logic, you can add optional serverless steps or conditional paths. For advanced automation, external scripts can extend the workflow, but the core connect-and-post flow remains code-free.
Required permission is the socialplanner/post.write scope. Ensure you have a valid token with this scope and keep tokens secure. Review rate limits in the API docs and request additional scopes if needed. Always follow best practices for credential management and least privilege.
Core endpoints include POST to create posts, PUT or PATCH to update, and DELETE to remove posts. LocationId ties requests to a specific account, and id identifies the post. A typical flow is POST to create, then PUT/PATCH to update, and DELETE when cleaning up.
Use a sandbox or test environment provided by Surveys API. Validate with test data, then run end-to-end tests that simulate real posting scenarios. Monitor logs and error responses to troubleshoot. After testing, enable production rollout with proper monitoring.
Yes. You can schedule posts or trigger them from survey events. Configure your Rankr workflow to space postings according to your campaign calendar. Combining survey-driven data with scheduling helps keep content timely and relevant.
Yes. A no-code approach is supported via built-in connectors and templates. You can configure triggers, mappings, and actions without writing code. If you need bespoke logic, you can add optional automation steps, but a full no-code solution is available.
Refer to the Surveys API and Rankr documentation for code samples, best practices, and example workflows. Our support team can help tailor templates to your use case. You can also explore community templates and tutorials for common posting scenarios.
Due to high volume, we will be upgrading our server soon!
Complete Operations Catalog - 126 Actions & Triggers
