GrowSocialelion API
Make your first API call in two minutes: create a key, read your brands, save a draft to the Inbox.
The API lets your code do what the dashboard does: read your brands, posts and metrics, find conversations worth joining, and save drafts for your social accounts. Every draft lands in your Inbox. A person approves it there before anything is posted.
There are 36 endpoints. Each one is also a tool on the GrowSocialelion MCP server, with the same name, the same arguments, the same key and the same limits. Learn one and you know both.
What the API will not do
1. Create an API key
Sign in and open Account > API keys. Create a key and copy it. It starts with gse_mcp_ and is shown once. The same key works for the REST API and for MCP.
2. Read your brands
curl https://growsocialelion.com/api/v1/list_brands \
-H "Authorization: Bearer gse_mcp_YOUR_KEY"The answer lists each brand with its brandId. Send X-GSE-Brand: <brandId> on later calls to act for one brand. Without the header, calls act for the key's first brand.
3. Save a draft to the Inbox
curl -X POST https://growsocialelion.com/api/v1/propose_post \
-H "Authorization: Bearer gse_mcp_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"We shipped dark mode today. Tell us what breaks.","platform":"bluesky"}'The answer has "status": "awaiting_human_approval", a proposalId and a link to the Inbox. Open the Inbox: the draft is there, marked API · your key's label, so you can tell it apart from the agent's drafts and from drafts your MCP client made.
How calls work
POST /api/v1/<tool_name>with the tool's arguments as a JSON object. An empty body means no arguments.- Read-only endpoints that never cost credits also take
GET, with the arguments in the query string. - The answer is the same JSON an MCP client gets. Errors have one shape: see Errors.
- The machine-readable spec is at /api/v1/openapi.json (OpenAPI 3.1). Try calls in the interactive reference.
Next
- Authentication and scopes: API keys, the X-GSE-Brand header, and the scopes that decide what a key may do.
- Endpoints: Every REST endpoint, which is also an MCP tool, with its scope and cost.
- Errors: Every error has the same body: status, code and a reason you can act on.
- Rate limits and credits: How many calls a key and a workspace may make, and which calls cost credits.
- MCP setup: Use the same key from Claude Code, Cursor, Claude Desktop or Grok Bot.
- Changelog: What changed in the API and the MCP server, newest first.