Requests to the Social Media API require a valid credential issued by your GHL account. For this integration, ensure the saas/company.write scope is enabled to manage accounts and posting workflows.
Authenticating Accelo to GHL uses OAuth credentials assigned to the Accelo app. Keep the client ID and secret secure and configure the redirect URI that completes the connection between Accelo and the Social Media API.
POST /bulk-disable-saas/:companyId — Disable SaaS access for a company; snapshots.readonly — Read-only access to snapshots; GET /snapshots — Retrieve snapshots; socialplanner/account.readonly — Read-only access to social planner accounts; GET /social-media-posting/:locationId/accounts — List accounts for a location; socialplanner/account.write — Create or update social planner accounts; DELETE /social-media-posting/:locationId/accounts/:id — Remove an account; socialplanner/csv.readonly — Read-only CSV data; GET /social-media-posting/:locationId/csv — List CSVs; GET /social-media-posting/:locationId/csv/:id — Retrieve a CSV; socialplanner/csv.write — Create or update CSV data; POST /social-media-posting/:locationId/csv — Upload a new CSV; POST /social-media-posting/:locationId/set-accounts — Link accounts to a location; DELETE /social-media-posting/:locationId/csv/:id — Delete a CSV; PATCH /social-media-posting/:locationId/csv/:id — Update a CSV; POST /social-media-posting/:locationId/posts/bulk-delete — Bulk delete posts; DELETE /social-media-posting/:locationId/csv/:csvId/post/:postId — Delete a specific post from a CSV
Trigger when a new account or location is added in Accelo to create a corresponding Social Planner account in the Social Media API.
Actions: write accounts via socialplanner/account.write, verify with socialplanner/account.readonly, and map locationId to accountId.
Key method paths include POST /social-media-posting/:locationId/set-accounts and GET /social-media-posting/:locationId/accounts.
Fields: locationId, accountId, status
Trigger when a new CSV is uploaded or posts are ready to be published in Accelo.
Actions: use CSV endpoints to upload, list, and modify CSVs; post-bulk delete via /posts/bulk-delete; manage CSV-post associations.
Key methods: POST /social-media-posting/:locationId/csv, GET /social-media-posting/:locationId/csv, PATCH /social-media-posting/:locationId/csv/:id, DELETE /social-media-posting/:locationId/csv/:id, DELETE /social-media-posting/:locationId/csv/:csvId/post/:postId, POST /social-media-posting/:locationId/posts/bulk-delete
Fields: locationId, csvId, postId, status
Trigger when a snapshot is generated or a CSV report is requested for client-ready data.
Actions: fetch GET /snapshots, GET /social-media-posting/:locationId/csv, GET /social-media-posting/:locationId/accounts to compile reports.
Key paths: GET /snapshots, GET /social-media-posting/:locationId/csv, GET /social-media-posting/:locationId/accounts
Fields: locationId, snapshotId, csvId
Automate social publishing and scheduling without writing code, using visual workflows.
Centralize content workflows in Accelo and GHL for faster approvals and consistent posting.
Gain real-time insight with built-in analytics and CSV exports for clients.
This glossary defines API endpoints, triggers, actions, and resources used in the Accelo–Social Media API integration.
A specific URL and HTTP method used to perform a function in an API.
Process to verify identity and obtain access to the API, typically via API keys or OAuth tokens.
An event that starts a workflow, such as a new account, CSV upload, or posting request.
Comma-separated values files used to batch upload or export data.
Set up a publishing cadence in Accelo that automatically posts to connected social accounts via the Social Media API.
Generate performance dashboards from snapshots and export CSV data for clients.
Onboard new social profiles by uploading a CSV and automatically linking accounts in Accelo.
In GHL, create a new app for the Social Media API integration and generate the client ID and secret.
Grant the necessary scopes (such as saas/company.write) and set redirect URIs for OAuth flows.
Run test requests to verify each endpoint and confirm data flows between Accelo and the Social Media API.
The Social Media API provides programmatic control over your social publishing workflow within Accelo. You can create accounts, upload and manage CSVs, schedule posts, and retrieve snapshots for reporting. This integration enables no-code automation, letting marketers build repeatable processes through visual workflows. It also exposes endpoints for deeper customization if you choose to code.
Yes. You can typically set up triggers and actions without writing code using the app connector and endpoints. If needed, you can extend the integration with custom requests. The no-code approach covers most common publishing, CSV and reporting needs.
Endpoints are grouped by function: accounts (creation and management), CSV handling, posting, and snapshots. Use accounts endpoints to link people and locations, CSV endpoints to upload and manage content, and the posting endpoints to publish and archive posts. Snapshots give you performance data for reporting.
Security relies on OAuth or API keys, with specific scopes like saas/company.write. Keep credentials secure, rotate them periodically, and enforce least privilege in your app configuration. Use HTTPS for all requests.
Snapshots capture performance metrics and can be exported as CSVs for clients. You can pull data on posts published, engagement, and impressions and combine this with CSV exports for client reports.
If a post fails or a CSV upload errors, check the API response for error codes, verify location and IDs, confirm CSV format, and re-run the request. Enable detailed logging and test endpoints in a sandbox environment.
API rate limits and quotas are documented in the API docs. Plan around bursts by batching requests, caching results, and staggering operations to avoid hitting quotas. Contact support if you need higher limits.
Due to high volume, we will be upgrading our server soon!
Complete Operations Catalog - 126 Actions & Triggers
