Authenticate requests using the Surveys API credentials and the required scope: socialplanner/post.write. Store keys securely and rotate them regularly.
Connect Rankr to the Surveys API by using your Rankr API key or OAuth token. Treat credentials like passwords and use least-privilege access.
POST /social-media-posting/:locationId/posts; PUT /social-media-posting/:locationId/posts/:id; DELETE /social-media-posting/:locationId/posts/:id; PATCH /social-media-posting/:locationId/posts/:id
Trigger: When a charity campaign is created in Rankr, automatically craft and publish a post via the Surveys API.
Actions: create post, schedule publish, and update post status based on campaign milestones.
POST /social-media-posting/:locationId/posts
locationId, content, media, schedule_time
Trigger: Charity site visitor submissions create leads in Rankr and kick off a related post workflow.
Actions: map lead fields to post payload, create or update posts, and consolidate analytics.
PUT /social-media-posting/:locationId/posts/:id
locationId, id, status, content
Trigger: Schedule- or event-based campaigns require post creation and lifecycle management.
Actions: PATCH to modify posts, DELETE obsolete posts, and ensure consistency across channels.
PATCH /social-media-posting/:locationId/posts/:id
locationId, id, content, status
No-code setup lets teams deploy integrations quickly without developers.
Automated workflows reduce manual steps and human error.
Scales across multiple charity campaigns, locations, and content types with consistency.
Key elements and processes include endpoints, triggers, actions, fields, and data mapping used to connect GHL’s Surveys API with Rankr.
Application Programming Interface — a set of rules and protocols that let apps talk to each other.
A specific URL in an API that performs a defined function or returns data.
An event that starts a workflow or action within the integration.
A data element used in API requests and responses to convey information.
Create a multi-post campaign sequence across social channels when a new charity campaign launches in Rankr via the Surveys API.
Automatically turn new charity leads captured on a website into social posts to boost engagement.
Post donor milestones and impact stories in real time using the Surveys API data feed.
Create or retrieve your Surveys API credentials for Rankr and set the proper scope (socialplanner/post.write).
Define the mapping between Rankr actions and the Surveys API endpoints, and test with sandbox data.
Run end-to-end tests and monitor for errors before going live.
The Surveys API provides a standardized way for Rankr to create and manage social posts via endpoint calls, enabling automation without heavy coding and allowing campaigns to deploy quickly. You can authenticate using API keys and ensure the correct scope is granted.
No-code options allow drag-and-drop setup within Rankr, but some advanced scenarios may require light scripting. We focus on guided configuration and prebuilt templates to minimize coding.
Typically you need locationId, post content, and status. The exact endpoints used depend on the action (create, update, delete, or patch).
Use a sandbox environment to verify payloads, simulate posts, and confirm that triggers fire as expected. Then run tests in production with comprehensive monitoring.
All credentials should be stored securely, rotate keys regularly, and apply least-privilege access. Use HTTPS and monitor for suspicious activity.
Yes. Rankr lets you configure triggers per campaign, channel, or location, so messaging can be tailored to different audiences or goals.
API documentation is included in the Surveys API section of Rankr’s support portal, plus you can reach support for code samples and best practices.
Due to high volume, we will be upgrading our server soon!
Complete Operations Catalog - 126 Actions & Triggers
