Authenticate requests with your Surveys API credentials (API key or OAuth) to securely authorize calls from TrueReview.
Configure TrueReview to securely connect to the Surveys API by creating an app credential and granting the necessary scopes.
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 — Modify a post
Trigger: New TrueReview feedback is ready to share on social media; publish a post via Surveys API immediately.
Actions: Create post with POST; optionally schedule using a time field.
POST /social-media-posting/:locationId/posts
locationId, content, scheduleTime, status
Trigger: TrueReview feedback updates require an edit to existing social posts.
Actions: Use PUT to update content and metadata via the endpoint.
PUT /social-media-posting/:locationId/posts/:id
locationId, id, content, updatedFields
Trigger: Posts become obsolete or need removal.
Actions: Delete via DELETE or disable via PATCH.
DELETE /social-media-posting/:locationId/posts/:id
locationId, id, reason
Benefit 1: Build powerful automations without writing code—connect feedback with social posting in minutes.
Benefit 2: Real-time data sync between TrueReview responses and audience engagement on social.
Benefit 3: Scalable workflows that grow with your brand’s feedback program.
A quick glossary of core elements and processes used to connect Surveys API with TrueReview, including endpoints, authentication, and data flow.
A credential used to authenticate requests to the Surveys API.
A specific URL path that performs an action in the API.
An authorization framework that lets apps access data securely without sharing passwords.
A unique identifier for a social location within Surveys API.
Trigger automatic survey prompts when TrueReview feedback is completed to gather more responses.
Publish standout TrueReview quotes as social posts via the Surveys API.
Create campaigns around common themes in TrueReview feedback to boost engagement.
Create API credentials in Surveys API and grant the socialplanner/post.write scope.
Choose the endpoints you need (POST, PUT, DELETE, PATCH) to enable your flow.
Run tests, verify data moves correctly, and go live with automation.
The Surveys API integration connects TrueReview feedback to your social channels by leveraging GHL’s posting endpoints. It enables automated publishing, real-time updates, and consistent content workflows without manual scripting.
No extensive coding is required if you use pre-built connectors and the provided endpoints. You’ll configure credentials once and map fields to post content and scheduling.
Required permissions include socialplanner/post.write to create posts and location-specific scopes. You may need read access for monitoring and admin rights for managing app credentials.
Yes. You can update or replace a post using PUT or PATCH depending on your need. Deleting is also supported with DELETE when a post is no longer needed.
To revoke access, disable the app in TrueReview and revoke API keys or OAuth tokens from Surveys API. Update scopes if you need to minimize permissions before revocation.
Data shared includes post content, scheduling details, and any feedback metadata used to drive posts. Strict security practices apply, and credentials never flow through the content of posts.
Endpoint documentation is available in the Surveys API docs portal or developer console. You can also reference the in-app docs within TrueReview’s connector section for endpoint specifics.
Due to high volume, we will be upgrading our server soon!
Complete Operations Catalog - 126 Actions & Triggers