Skip to main content
The HoopAI Platform Social Planner REST API gives you complete programmatic control over social media publishing. Create and schedule posts to multiple connected accounts, manage OAuth connections for Facebook, Instagram, LinkedIn, Google My Business, Twitter/X, and TikTok, bulk-upload posts via CSV, and organize content with categories, tags, and category queues — all from your own application.

​
Base URL

https://services.leadconnectorhq.com

​
Authentication

Every request requires a Bearer token and an API version header. 
Authorization: Bearer <access_token>
Version: 2021-07-28
Use an access token generated with user type Sub-Account, or a Private Integration Token from a Sub-Account. See OAuth 2.0 for details.
OAuth start endpoints (e.g. /social-media-posting/oauth/facebook/start) must be opened in a browser, not called with cURL. They redirect the user to the platform login screen and return an accountId via a window message event. Use that accountId with the corresponding attach endpoint to complete the connection.

​
OAuth scopes

ScopeAccess granted
socialplanner/post.readonlyRead posts
socialplanner/post.writeCreate, update, and delete posts
socialplanner/account.readonlyRead connected social accounts
socialplanner/account.writeConnect and remove social accounts
socialplanner/csv.readonlyRead CSV uploads
socialplanner/csv.writeUpload and manage CSV bulk posts
socialplanner/category.readonlyRead post categories
socialplanner/tag.readonlyRead post tags

​
Quick start

Create a new social media post: 
curl -X POST "https://services.leadconnectorhq.com/social-media-posting/<locationId>/posts" \
  -H "Authorization: Bearer <access_token>" \
  -H "Version: 2021-07-28" \
  -H "Content-Type: application/json" \
  -d '{
    "accountIds": ["<accountId>"],
    "summary": "Check out our latest update!",
    "scheduleDate": "2026-04-01T10:00:00.000Z"
  }'

​
Endpoints

​
Posts

MethodPathDescription
POST/social-media-posting/{locationId}/posts/listGet posts
POST/social-media-posting/{locationId}/postsCreate post
GET/social-media-posting/{locationId}/posts/{id}Get post
PUT/social-media-posting/{locationId}/posts/{id}Edit post
DELETE/social-media-posting/{locationId}/posts/{id}Delete post
POST/social-media-posting/{locationId}/posts/bulk-deleteBulk delete posts

​
Accounts

MethodPathDescription
GET/social-media-posting/{locationId}/accountsGet accounts
DELETE/social-media-posting/{locationId}/accounts/{id}Delete account

​
OAuth — Google

MethodPathDescription
GET/social-media-posting/oauth/google/startStart Google OAuth
GET/social-media-posting/oauth/{locationId}/google/locations/{accountId}Get Google business locations
POST/social-media-posting/oauth/{locationId}/google/locations/{accountId}Set Google business locations

​
OAuth — Facebook

MethodPathDescription
GET/social-media-posting/oauth/facebook/startStart Facebook OAuth
GET/social-media-posting/oauth/{locationId}/facebook/accounts/{accountId}Get Facebook pages
POST/social-media-posting/oauth/{locationId}/facebook/accounts/{accountId}Attach Facebook pages

​
OAuth — Instagram

MethodPathDescription
GET/social-media-posting/oauth/instagram/startStart Instagram OAuth
GET/social-media-posting/oauth/{locationId}/instagram/accounts/{accountId}Get Instagram professional accounts
POST/social-media-posting/oauth/{locationId}/instagram/accounts/{accountId}Attach Instagram professional accounts

​
OAuth — LinkedIn

MethodPathDescription
GET/social-media-posting/oauth/linkedin/startStart LinkedIn OAuth
GET/social-media-posting/oauth/{locationId}/linkedin/accounts/{accountId}Get LinkedIn pages and profile
POST/social-media-posting/oauth/{locationId}/linkedin/accounts/{accountId}Attach LinkedIn pages and profile

​
OAuth — Twitter

MethodPathDescription
GET/social-media-posting/oauth/twitter/startStart Twitter OAuth
GET/social-media-posting/oauth/{locationId}/twitter/accounts/{accountId}Get Twitter profile
POST/social-media-posting/oauth/{locationId}/twitter/accounts/{accountId}Attach Twitter profile

​
OAuth — TikTok

MethodPathDescription
GET/social-media-posting/oauth/tiktok/startStart TikTok OAuth
GET/social-media-posting/oauth/{locationId}/tiktok/accounts/{accountId}Get TikTok profile
POST/social-media-posting/oauth/{locationId}/tiktok/accounts/{accountId}Attach TikTok profile
GET/social-media-posting/oauth/tiktok-business/startStart TikTok Business OAuth
GET/social-media-posting/oauth/{locationId}/tiktok-business/accounts/{accountId}Get TikTok Business profile

​
OAuth — Generic

MethodPathDescription
GET/social-media-posting/oauth/{platform}/startStart OAuth for any supported platform
GET/social-media-posting/oauth/{locationId}/{platform}/accounts/{accountId}Get OAuth accounts
POST/social-media-posting/oauth/{locationId}/{platform}/accounts/{accountId}Attach OAuth accounts

​
CSV bulk upload

MethodPathDescription
POST/social-media-posting/{locationId}/csvUpload CSV
GET/social-media-posting/{locationId}/csvGet CSV upload status
POST/social-media-posting/{locationId}/set-accountsSet accounts for CSV
GET/social-media-posting/{locationId}/csv/{id}Get CSV post
PATCH/social-media-posting/{locationId}/csv/{id}Finalize CSV
DELETE/social-media-posting/{locationId}/csv/{id}Delete CSV
DELETE/social-media-posting/{locationId}/csv/{csvId}/post/{postId}Delete CSV post

​
Categories and tags

MethodPathDescription
GET/social-media-posting/{locationId}/categoriesGet categories by location
GET/social-media-posting/{locationId}/categories/{id}Get category by ID
GET/social-media-posting/{locationId}/tagsGet tags by location
POST/social-media-posting/{locationId}/tags/detailsGet tags by IDs

​
Statistics

MethodPathDescription
POST/social-media-posting/statisticsGet social media statistics

​
Category queues

MethodPathDescription
GET/social-media-posting/category/queues/available-categoriesGet available categories
POST/social-media-posting/category/queuesCreate queue
POST/social-media-posting/category/queues/listFetch queues
POST/social-media-posting/category/queues/list/calendarFetch calendar list
GET/social-media-posting/category/queues/{queueId}Fetch queue by ID
PUT/social-media-posting/category/queues/{queueId}Update queue
DELETE/social-media-posting/category/queues/{queueId}/active-postDelete active post
POST/social-media-posting/category/queues/{queueId}/itemsFetch queue items
POST/social-media-posting/category/queues/{queueId}/create/itemCreate queue item
DELETE/social-media-posting/category/queues/{queueId}/items/{itemId}Delete queue item
PUT/social-media-posting/category/queues/{queueId}/items/{itemId}Update queue item
PUT/social-media-posting/category/queues/{queueId}/items/{itemId}/resetReset queue item
POST/social-media-posting/category/queues/{queueId}/items/{itemId}/cloneClone queue item
POST/social-media-posting/category/queues/{queueId}/slotsFetch queue slots
POST/social-media-posting/category/queues/{queueId}/edit/startStart edit session
POST/social-media-posting/category/queues/{queueId}/edit/saveSave edit session
POST/social-media-posting/category/queues/{queueId}/edit/discardDiscard edit session
POST/social-media-posting/category/queues/{queueId}/edit/calendarFetch edit session calendar
Last modified on March 4, 2026