Authenticate with a secure token or API key to access endpoints like tags and statistics. Use OAuth 2.0 where supported.
HeyReach uses OAuth 2.0 client credentials to obtain access tokens that authorize calls to the GHL Users API on your behalf.
GET /social-media-posting/:locationId/tags POST /social-media-posting/:locationId/tags/details socialplanner/statistics.readonly POST /social-media-posting/statistics Additional endpoints can be enabled as needed to expand capabilities.
Trigger: a new tag is created or updated in GHL Users API
Actions: HeyReach creates or updates posts linked to that tag and schedules distribution
GET /social-media-posting/:locationId/tags
locationId, tagId, tagName
Trigger: fetch statistics via social endpoints
Actions: feed HeyReach dashboards with performance metrics
POST /social-media-posting/statistics
Trigger: tag details update from GHL to HeyReach
Actions: enrich HeyReach campaigns with tag details
POST /social-media-posting/:locationId/tags/details
locationId, tagId, details
Automated workflows without writing code; configure endpoints and triggers in your app settings.
Centralized analytics and reporting pulled directly into HeyReach dashboards.
Faster iteration with pre-built API endpoints and clear data mapping.
Definitions of terms used in this guide, including API, endpoint, authentication, and data mapping.
A set of rules that lets applications communicate and exchange data securely.
A specific path in an API that performs a defined operation.
A process to verify identity before granting access to resources, often via tokens.
An authorization framework that enables secure, delegated access to APIs without sharing user credentials.
Automatically trigger HeyReach campaigns when new tags appear in GHL Users API.
Pull performance data to plan future posts in HeyReach.
Show tag health and usage metrics in a live HeyReach view.
Create API credentials and authorize HeyReach to call GHL endpoints.
Enable the needed endpoints (tags and statistics) in your GHL settings.
Run tests and monitor data flow between GHL and HeyReach.
No-code setup is possible using the pre-built endpoints and webhooks. Configure endpoints in app settings and use OAuth tokens for secure access. This guide covers authentication, endpoint selection, testing, and monitoring.
For basic tagging, fetch tags with GET /social-media-posting/:locationId/tags and submit details with POST /social-media-posting/:locationId/tags/details. Analytics and statistics endpoints provide deeper insights.
Use OAuth 2.0 with client credentials to obtain access tokens; include the token in the Authorization header for each call. Then use the endpoints to read or write data.
Yes. Map GHL tags to HeyReach campaigns by creating mapping rules and syncing tag metadata through the details endpoint.
API rate limits apply based on your plan. If you hit limits, implement exponential backoff and caching where suitable.
Integration logs appear in the HeyReach dashboard under API connections. Filter by date and endpoint to diagnose issues; enable verbose logging if needed.
For help, contact support or consult the developer docs. We also offer templates and a starter workspace.
Due to high volume, we will be upgrading our server soon!
Complete Operations Catalog - 126 Actions & Triggers
