✦
OnePost/ Developers
Go to app →
DEVELOPER PORTAL

OnePost API

Integrate newsletter repurposing into your workflow. REST API, webhooks, and Zapier integration — all in one place.

🔑 Your API Key

Free plan — upgrade to Pro for API access

Upgrade to Pro to generate an API key

⚡ Interactive Playground

Test the generate API live. Paste your newsletter content and see the output.

172 chars

📖 API Reference

Base URL: https://useonepost.com

POST/api/v1/generatePro

Generate Social Posts

Generate platform-native social media posts from newsletter content. Returns posts for all 7 platforms.

Request Body
contentstring (required) — Newsletter text (min 50 chars)
subscribe_urlstring (optional) — Your newsletter subscribe link
platformsstring[] (optional) — Subset of platforms to generate for
output_language'auto' | 'en' | 'zh' (optional) — Output language
Response
twitterstring — Tweet (≤280 chars)
linkedinstring — LinkedIn post (800-1500 chars)
threadsstring — 3-4 Threads posts separated by ---
reddit{ title: string, body: string } — Reddit post as JSON string
blueskystring — Bluesky post (≤300 chars)
xiaohongshu{ title: string, body: string } — 小红书 post as JSON string
instagramstring — Instagram caption (≤500 chars)
curl -X POST https://useonepost.com/api/v1/generate \
  -H "Authorization: Bearer YOUR_SUPABASE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Your newsletter text here...",
    "subscribe_url": "https://yoursite.com/subscribe"
  }'
GET/api/webhooksFree

Get Webhook Config

Retrieve the current webhook configuration for the authenticated user.

Response
webhook_urlstring | null
webhook_eventsstring[]
webhook_enabledboolean
curl https://useonepost.com/api/webhooks \
  -H "Cookie: YOUR_SESSION_COOKIE"
POST/api/webhooks/testFree

Test Webhook

Send a test payload to the configured webhook URL to verify connectivity.

Response
okboolean
statusnumber — HTTP status from your webhook endpoint
messagestring
curl -X POST https://useonepost.com/api/webhooks/test \
  -H "Cookie: YOUR_SESSION_COOKIE"

📊 Rate Limits & Quotas

Free
5 generations / day
No API access
Pro
Unlimited
Full API access
Team
Unlimited
Full API access + team sharing
Upgrade to Pro for API access →