Social CSV Import
Bulk-import social media posts from CSV files. Upload content, check import status, and assign social accounts to imported posts for batch scheduling.
Planning a month’s worth of social content in a spreadsheet and then uploading it all at once is far more efficient than creating posts one at a time. Social CSV Import lets you bulk-import posts from CSV files, check the import status, and assign connected social accounts to the imported content.
What This MCP Tool Does
Upload a CSV file containing social media posts, check the import processing status, and assign social accounts to imported posts. This is the batch-creation counterpart to Social Post CRUD.
Endpoint Reference
Upload CSV: POST /social-media-posting/csv
Check import status: GET /social-media-posting/csv/{importId}
Assign accounts: POST /social-media-posting/csv/{importId}/accounts
Authentication
Requires a Private Integration Token (PIT) with the social-media-posting scope enabled.
Key Parameters
file— the CSV file containing post dataimportId— returned after upload, used to check status and assign accountsaccountIds— social accounts to assign to imported posts
Important Notes
The CSV format must follow GHL’s expected structure. Typically: post content, scheduled date/time, media URLs, and category tags. Check GHL’s documentation for the current CSV template format.
Import is a two-step process: upload the CSV first, then assign social accounts to the imported posts. Posts aren’t scheduled until accounts are assigned.
Processing is asynchronous. After upload, poll the status endpoint until the import is complete before assigning accounts.
Common Questions
What’s the CSV format? GHL provides a template. Columns typically include post content, schedule date, media URLs, and optional metadata.
Can I assign different accounts to different posts in the same import? The account assignment applies to the entire import batch. For different account assignments, use separate CSV imports.
How many posts can I import at once? Depends on GHL’s import limits. Hundreds of posts per import is typical.
Related MCP Tools
- Social Post CRUD — Individual post creation
- Social Post Search — Find imported posts after processing
- Social Accounts — Get account IDs for assignment
- Social Bulk Delete — Clean up imported posts if needed
- Media Library — Upload media referenced in CSV posts