Authenticate requests from Rankr to the Surveys API using provided API keys and scoped permissions. Store credentials securely, rotate keys regularly, and use OAuth where available to maintain a strong security posture.
Rankr authenticates with the Surveys API by presenting valid credentials and adhering to the defined scopes. Ensure tokens are stored securely and refreshed before expiry to maintain seamless connections.
POST /social-media-posting/:locationId/posts — Create a new post PUT /social-media-posting/:locationId/posts/:id — Update a post DELETE /social-media-posting/:locationId/posts/:id — Delete a post PATCH /social-media-posting/:locationId/posts/:id — Partial update of a post
Trigger: A new post is drafted in Surveys API.
Actions: Publish to connected social channels from Rankr and update the post status back to Surveys API.
POST /social-media-posting/:locationId/posts
Required fields: locationId, content; optional: media, scheduledTime; id is returned after creation.
Trigger: Content updates or status changes are needed.
Actions: Use PUT for full updates or PATCH for partial updates; re-sync the status with Surveys API.
PUT /social-media-posting/:locationId/posts/:id
Key fields: locationId, id, content; scheduledTime and media can be updated with PATCH.
Trigger: Post is obsolete or no longer needed.
Actions: Delete via DELETE; remove from Rankr records and downstream channels.
DELETE /social-media-posting/:locationId/posts/:id
Key fields: locationId, id.
Automate social posting without writing code.
Create a centralized content workflow between Surveys API and Rankr.
Get real-time updates, reporting, and analytics to optimize engagement.
This glossary explains core terms and processes used when integrating Surveys API with Rankr.
Sends a new social post to the specified location via the Surveys API.
Replaces an existing post entirely or updates key fields with a full payload.
Updates only selected fields of a post without altering others.
Removes a post from the system and related records.
Pull fresh survey highlights and publish a weekly digest to social channels.
Automate updates when respondents submit surveys, keeping content fresh.
Repurpose top questions and answers into recurring posts to boost engagement.
Obtain API keys and grant necessary permissions to Rankr.
Enter the locationId and map endpoints for create, update, patch, and delete.
Run test posts and verify results across channels.
The best way to start is to authorize Rankr to access the Surveys API and map your location in the Rankr interface. This creates a trusted bridge that lets Rankr push content to your connected social channels. From there you can build automated posting workflows without writing code. Rankr dashboards provide a clear view of publishing activity, engagement, and scheduling tips to optimize campaigns over time.
The primary endpoints are POST for creating posts, PUT for full updates, PATCH for partial updates, and DELETE for removal. You will specify a locationId to target the correct workspace and, for updates and deletions, the post id. These endpoints support a complete lifecycle from creation through deletion, enabling smooth automation across your social channels.
No heavy coding is required. The integration relies on standard HTTP requests and API keys (with optional OAuth scopes) that Rankr can orchestrate in its interface. Advanced users can add custom logic later if needed. If you can follow basic API concepts, you can configure mappings, triggers, and actions quickly to start automating your posts.
Security is handled with scoped API keys and tokens, encrypted transport, and regular credential rotation. Ensure tokens are stored securely and implement robust error handling and retry policies to manage transient failures. For added protection, enable least-privilege access and monitor API activity to detect anomalies in posting behavior.
Yes. You can schedule posts by including a scheduledTime in your create or update calls, allowing Rankr to publish posts automatically at the specified time. This enables evergreen content strategies and aligns posts with campaigns, events, or peak engagement times without manual intervention.
Deleted posts can be removed from both Surveys API and Rankr records per your data policy. Depending on settings, data may be archived before deletion for compliance. Use the DELETE endpoint to permanently remove a post and any linked records if you require a full purge.
Analytics and posting history are available in Rankr’s dashboards, with data synchronized from Surveys API events. You can review performance, engagement metrics, and scheduling outcomes to optimize future content. If needed, export reports or create custom views to monitor key KPIs over time.
Due to high volume, we will be upgrading our server soon!
Complete Operations Catalog - 126 Actions & Triggers
