Use OAuth 2.0 with the scope socialplanner/tag.readonly to securely authorize ReferralHero to read tag data and basic analytics from your GHL account.
To connect, complete the OAuth flow in ReferralHero, grant the requested permissions, and securely store the access token for ongoing API calls.
Endpoints used: GET /social-media-posting/:locationId/tags to fetch tags; POST /social-media-posting/:locationId/tags/details to retrieve tag details; GET /socialplanner/statistics.readonly for read-only metrics; POST /social-media-posting/statistics to generate or refresh statistics.
Trigger when a location’s tags are updated, prompting ReferralHero to pull the latest tag data and update campaigns accordingly.
Actions: Use GET /social-media-posting/:locationId/tags to list tags, and POST /social-media-posting/:locationId/tags/details to fetch tag details for enrichment in campaigns.
GET /social-media-posting/:locationId/tags
locationId, tags, details
Trigger: on-demand or scheduled runs to fetch analytics and inform posting strategy.
GET socialplanner/statistics.readonly
locationId, metrics, dateRange
Trigger: schedule-based posting driven by tag data and analytics.
Actions: POST /social-media-posting/statistics to adjust posting cadence; POST /social-media-posting/:locationId/tags/details to attach tag details to posts.
POST /social-media-posting/statistics
locationId, postingSchedule, tags
Zero-code integration with secure OAuth and pre-built endpoints that map directly to referral campaigns.
Fast setup and easy maintenance without custom development, plus visual workflow options.
Automatic data syncing for consistent campaigns, improved targeting, and measurable results.
Key elements and processes include OAuth authorization, endpoint usage for tags and statistics, data mapping to referrals, and robust error handling to ensure reliable no-code integration.
A standard authorization framework that lets ReferralHero access GHL data securely without handling user passwords.
A unique identifier for a social location in GHL used to fetch tags and post statistics.
Tag labels that categorize content and audience segments for targeted campaigns.
Metrics gathered from posts, such as reach, impressions, clicks, and engagement over time.
Automatically tailor posts and offers based on tag data pulled from the GHL Users API to boost engagement and conversions.
Build dashboards that visualize tag performance, posting statistics, and campaign outcomes in ReferralHero.
Automate posting cadence and cadence adjustments based on tag events and analytics trends.
Obtain OAuth client credentials and configure Redirect URI in ReferralHero.
Run the OAuth flow, grant socialplanner/tag.readonly, and confirm access to required data.
Test endpoints in a sandbox environment, verify data mappings, then switch to production.
No heavy coding is required thanks to the no-code connectors and pre-built endpoints. ReferralHero handles the OAuth flow and data mapping for you. You can configure triggers and actions using a visual builder. The result is faster setup and easier maintenance compared with custom development. Whether you’re a marketer or a product manager, this integration lets you automate tag-based campaigns without writing code, reducing friction and speeding time-to-value.
The Users API exposes tag data and analytics through endpoints like GET /social-media-posting/:locationId/tags and GET /socialplanner/statistics.readonly. You can read tag lists, retrieve tag details, and view posting statistics to inform campaigns. The data helps tailor content and measure performance across locations and campaigns. Always ensure you have the correct OAuth scopes (e.g., socialplanner/tag.readonly) to access this information.
Key endpoints include: GET /social-media-posting/:locationId/tags for tag retrieval, POST /social-media-posting/:locationId/tags/details for tag detail enrichment, GET socialplanner/statistics.readonly for read-only metrics, and POST /social-media-posting/statistics to generate or refresh statistics. These cover tagging, analytics, and cadence optimization for posting. You don’t need to call every endpoint—use only the ones necessary for your campaign workflows.
Required permissions include OAuth scopes such as socialplanner/tag.readonly to read tag data and basic analytics. You’ll also need access tokens with appropriate refresh settings to maintain a seamless connection. ReferralHero guides you through granting these scopes during the OAuth flow.
Data can be synced on a schedule (e.g., daily or hourly) or triggered on demand. The no-code setup lets you configure cadence without coding. You can also create real-time triggers for tag updates to keep campaigns current.
Yes. Use a sandbox or staging environment to test endpoint calls, data mappings, and automations. Validate responses and monitor logs before going live. This helps catch permission or data-mapping issues early.
Absolutely. This integration is designed for no-code usage with clear visual workflows and pre-built endpoint calls. If you ever need deeper customization, you can extend the setup with advanced options, but you can start and operate fully without writing code.
Due to high volume, we will be upgrading our server soon!
Complete Operations Catalog - 126 Actions & Triggers
