Reepl API Documentation

The Reepl API lets you programmatically manage social content and automation workflows across LinkedIn, X/Twitter, Threads, and Google Business Profile. Build integrations that create drafts, publish and schedule posts, generate carousels, read long-form articles, and receive real-time webhook notifications.

API Endpoints

User

GET /external/me - Get your user profile, subscription, and connected accounts.

Drafts

GET /external/drafts - List all drafts with optional pagination. POST /external/drafts - Create a new draft with text content and optional media. GET /external/drafts/{draftId} - Retrieve a draft. PUT /external/drafts/{draftId} - Update an existing draft. DELETE /external/drafts/{draftId} - Delete a draft.

Posts

GET /external/posts - List published and scheduled posts. POST /external/posts/publish - Publish a post to LinkedIn immediately. POST /external/posts/schedule - Schedule a post for future publishing. PUT /external/posts/{postId} - Update a scheduled post. DELETE /external/posts/{postId} - Delete a scheduled post. POST /external/posts/{postId}/publish-now - Publish a scheduled post immediately. POST /external/posts/{postId}/comments - Add a comment to a published post.

AI Tools

POST /external/tools/carousel - Generate carousel slides from a topic or source content. POST /external/tools/virality - Analyze a post's viral potential with an AI-powered score.

Carousels

POST /external/carousel - Create an AI-generated or manually defined LinkedIn carousel draft. GET /external/carousel - List carousel drafts. GET, PUT, and DELETE /external/carousel/{draftId} - Retrieve, update, or delete a carousel draft.

Articles

GET /external/articles - List long-form articles in your workspace. GET /external/articles/{articleId} - Retrieve a single article with its per-destination publishing status. Read-only; requires the articles:read scope.

Webhooks

GET /external/webhooks/subscriptions - List webhook subscriptions. POST /external/webhooks/subscriptions - Create a webhook to receive real-time event notifications. GET, PUT, and DELETE /external/webhooks/subscriptions/{subscriptionId} - Retrieve, update, or remove a subscription. POST /external/webhooks/test - Send a test delivery. Deliveries are signed with HMAC-SHA256 and retried with backoff.

X/Twitter

POST and GET /external/twitter/posts - Create, schedule, and list tweets. GET, PUT, and DELETE /external/twitter/posts/{postId} - Retrieve, update, or delete a tweet. GET /external/twitter/posts/{postId}/analytics and GET /external/twitter/analytics - Per-post and aggregate analytics. POST /external/twitter/repurpose - Repurpose LinkedIn content for X.

Threads and Google Business Profile

Endpoints exist for Threads posts and analytics, and for Google Business Profile posts, reviews, and analytics. Neither platform can currently be connected in the Reepl app, so these endpoints are documented but not yet usable.

Authentication

All API requests require an API key. Send it in the X-API-Key header, or as a bearer token in the Authorization header. Generate API keys from Settings then Developers in the Reepl dashboard. Keys are scoped: user:read, drafts:read, drafts:write, posts:read, posts:write, carousel:read, carousel:write, articles:read, tools:use, webhooks:manage, twitter:read, twitter:write, threads:read, threads:write, gbp:read, and gbp:write. The contacts:read and contacts:write scopes are deprecated.

Rate Limits

GET requests: 300 per minute. POST/PUT/DELETE requests: 60 per minute. Webhook management: 100 per minute.