wavpost · Post, schedule & engage everywhere

Introduction

wavpost lets you publish to LinkedIn, Twitter, and YouTube from a single HTTP endpoint. Connect accounts once via OAuth — then post everywhere with one call.

Base URL

https://api.wavpost.com

Auth

Bearer token

Format

JSON

Authentication

All endpoints require an Authorization: Bearer <token> header. Two token types are accepted:

API Key

Recommended

Generate from the dashboard. Starts with sk_live_. Never expires unless revoked.

Authorization: Bearer sk_live_your_api_key_here

Firebase ID Token

Short-lived JWT from Firebase Auth. Used by the dashboard UI.

Authorization: Bearer eyJhbGciOiJSUzI1NiJ9...

Quickstart

From zero to publishing in 3 steps.

Get your API key

Go to Dashboard → API Keys → Create key.

sk_live_abc123efg456...  # store this securely, shown only once

Check connected platforms

curl https://api.wavpost.com/api/connect/status \
  -H "Authorization: Bearer sk_live_your_key"

Publish a post

curl -X POST https://api.wavpost.com/api/v1/posts \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Hello from the API!",
    "platforms": ["linkedin", "twitter"]
  }'

Posts

POST/api/v1/postsPublish a post

Parameters

Name	Type	Description
text*	string	Post content. Max 3000 chars for LinkedIn.
platforms*	string[]	linkedin · twitter · youtube
mediaUrls	string[]	Public image URLs. Up to 9 for LinkedIn.
scheduledFor	datetime	ISO 8601 UTC. Saves post as scheduled.
profile	string	Profile slug. Defaults to default profile.

curl -X POST https://api.wavpost.com/api/v1/posts \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "New feature drop!",
    "platforms": ["linkedin", "twitter"],
    "mediaUrls": ["https://your-cdn.com/image.jpg"]
  }'

Response 201

{
  "id": "a6c01b90-37da-4224-9338-e2025626b7bf",
  "text": "New feature drop!",
  "platforms": ["linkedin", "twitter"],
  "status": "published",
  "createdAt": "2025-03-19T07:19:57Z",
  "platformResults": {
    "linkedin": { "ok": true, "platformPostId": "urn:li:share:123456" },
    "twitter": { "ok": false, "error": "Twitter not connected." }
  }
}

GET/api/v1/postsList all posts

curl https://api.wavpost.com/api/v1/posts \
  -H "Authorization: Bearer sk_live_your_key"

Profiles

Profiles let you manage multiple brands or clients. Each profile has its own set of connected platform accounts. A default profile is created automatically on signup.

GET/api/profilesList profiles

curl https://api.wavpost.com/api/profiles \
  -H "Authorization: Bearer sk_live_your_key"

POST/api/profilesCreate a profile

Parameters

Name	Type	Description
name*	string	Display name for the profile

curl -X POST https://api.wavpost.com/api/profiles \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"name": "My Brand"}'

PATCH/api/profiles/{profileId}Update a profile

Parameters

Name	Type	Description
name	string	New display name
isDefault	boolean	Set as the default profile

DELETE/api/profiles/{profileId}Delete a profile

curl -X DELETE https://api.wavpost.com/api/profiles/profile-uuid \
  -H "Authorization: Bearer sk_live_your_key"

Connections

Connect social accounts via OAuth. Users open the connect URL in their browser — no platform developer apps needed.

GET/api/connect/statusCheck platform connection status

Parameters

Name	Type	Description
profileId	string	Query param. Uses default profile if omitted.

curl "https://api.wavpost.com/api/connect/status?profileId=uuid" \
  -H "Authorization: Bearer sk_live_your_key"

Response 200

{
  "linkedin": { "connected": true,  "displayName": "Anshu Raj Singh" },
  "twitter":  { "connected": false, "displayName": null },
  "youtube":  { "connected": false, "displayName": null }
}

GET/api/auth/{platform}Start OAuth (browser redirect)

Open this URL in a browser to start the OAuth flow. After connecting, the user is redirected to the dashboard.

# Open in browser — supported platforms: linkedin, twitter, youtube
https://api.wavpost.com/api/auth/linkedin?profileId=your-profile-id

POST/api/connect/{platform}/disconnectDisconnect a platform

Parameters

Name	Type	Description
profileId	string	Optional. Uses default profile if omitted.

curl -X POST https://api.wavpost.com/api/connect/linkedin/disconnect \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"profileId": "uuid"}'

Logs

Every publish attempt, platform connection, and profile change is automatically logged.

GET/api/logsGet activity logs

Parameters

Name	Type	Description
limit	integer	Number of logs. Default 50, max 200.
offset	integer	Pagination offset. Default 0.

curl "https://api.wavpost.com/api/logs?limit=20&offset=0" \
  -H "Authorization: Bearer sk_live_your_key"

Response 200

{
  "logs": [
    {
      "id": "uuid",
      "action": "post.published",
      "platform": "linkedin",
      "profileName": "Default",
      "status": "success",
      "metadata": {
        "text": "New feature drop!",
        "platformPostId": "urn:li:share:123456"
      },
      "createdAt": "2025-03-19T07:19:57Z"
    }
  ],
  "total": 42,
  "limit": 20,
  "offset": 0
}

Action types

post.publishedplatform.connectedplatform.disconnectedprofile.createdprofile.deleted

API Keys

API keys start with sk_live_ and don't expire unless revoked. The raw key is shown only once — store it immediately.

GET/api/keysList API keys

curl https://api.wavpost.com/api/keys \
  -H "Authorization: Bearer sk_live_your_key"

POST/api/keysCreate an API key

Parameters

Name	Type	Description
name*	string	Label to identify this key

curl -X POST https://api.wavpost.com/api/keys \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"name": "My agent key"}'

Response 201

{
  "key": { "id": "uuid", "name": "My agent key", "keyPreview": "...x9z2" },
  "rawKey": "sk_live_abc123..."  // shown only once
}

DELETE/api/keys/{keyId}Revoke an API key

curl -X DELETE https://api.wavpost.com/api/keys/key-uuid \
  -H "Authorization: Bearer sk_live_your_key"

Usage & Credits

Check your current plan, credit balance, and recent usage transactions.

GET/api/usageGet usage and credit balance

curl https://api.wavpost.com/api/usage \
  -H "Authorization: Bearer sk_live_your_key"

Response 200

{
  "plan": {
    "id": "free",
    "label": "Free",
    "price": 0
  },
  "credits": {
    "balance": 480,
    "monthlyAllowance": 500,
    "used": 20,
    "resetAt": "2026-04-01T00:00:00.000Z"
  },
  "recentTransactions": [
    {
      "amount": -2,
      "action": "post.published",
      "metadata": { "platforms": ["linkedin"], "breakdown": { "linkedin": 2 } },
      "createdAt": "2026-03-20T09:56:05.000Z"
    }
  ]
}

Credit costs

Action	Cost
LinkedIn post (text)	1 credit
LinkedIn post (with images)	2 credits
Twitter/X post (text)	3 credits
Twitter/X post (with images)	4 credits
YouTube post	1 credit
Analytics fetch	2 credits
Credits reset	Monthly, on plan renewal

Current access

Scopes approved: openid profile email w_member_social — covers personal profile identity and publishing posts as a member.

1. Connect a LinkedIn account

Open the OAuth URL in a browser. After the user grants access, they are redirected back and the account is saved to the profile.

GET/api/auth/linkedinStart LinkedIn OAuth

Parameters

Name	Type	Description
profileId	string	Query param. Which profile to connect the account to. Uses default if omitted.

# Open in browser
https://api.wavpost.com/api/auth/linkedin?profileId=your-profile-id

2. What profile data is returned

After connecting, WavPost fetches the user's identity via the OpenID Connect /v2/userinfo endpoint.

Field	Scope	Description
sub	openid	Unique LinkedIn member ID
name	profile	Full name
picture	profile	Profile photo URL
email	email	Primary email address

// Stored internally as:
{
  "id": "abc123",                        // LinkedIn member ID (sub)
  "authorUrn": "urn:li:person:abc123",   // used as post author
  "displayName": "Anshu Raj Singh",
  "picture": "https://media.licdn.com/..."
}

3. Publishing posts

Use the standard POST /api/v1/posts endpoint with "linkedin" in the platforms array.

Text post

curl -X POST https://api.wavpost.com/api/v1/posts \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Excited to share our latest update!",
    "platforms": ["linkedin"]
  }'

Single image post

curl -X POST https://api.wavpost.com/api/v1/posts \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Check out this visual!",
    "platforms": ["linkedin"],
    "mediaUrls": ["https://your-cdn.com/image.jpg"]
  }'

Multi-image post (up to 9)

curl -X POST https://api.wavpost.com/api/v1/posts \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Our product gallery:",
    "platforms": ["linkedin"],
    "mediaUrls": [
      "https://your-cdn.com/img1.jpg",
      "https://your-cdn.com/img2.jpg",
      "https://your-cdn.com/img3.jpg"
    ]
  }'

4. Response

{
  "id": "post-uuid",
  "status": "published",
  "platformResults": {
    "linkedin": {
      "ok": true,
      "platformPostId": "urn:li:share:7123456789"
    }
  }
}

The platformPostId is the LinkedIn post URN — you can use this to reference the post on LinkedIn.

5. Limits & notes

Constraint	Value
Max text length	3,000 characters
Max images per post	9 (multi-image carousel)
Image format	JPEG, PNG, GIF (public URL required)
Post visibility	PUBLIC (feed distribution)
Post author	Personal member only (company pages require Community Management API)
Access token expiry	60 days (LinkedIn default)

Coming soon — pending LinkedIn approval

• Post as company/organization pages — requires w_organization_social
• Read post analytics (likes, impressions, shares) — requires r_member_social
• Organization follower & visitor analytics — requires rw_organization_admin

Twitter / X

Current access

Uses OAuth 2.0 PKCE. Scopes requested:

tweet.readtweet.writeusers.readoffline.accessmedia.writelike.readlike.writefollows.readfollows.writebookmark.readbookmark.writetweet.moderate.writedm.readdm.write

1. Connect a Twitter / X account

GET/api/auth/twitterStart Twitter OAuth (PKCE)

Parameters

Name	Type	Description
profileId	string	Query param. Which profile to connect the account to. Uses default if omitted.

# Open in browser
https://api.wavpost.com/api/auth/twitter?profileId=your-profile-id

2. Profile data returned

Field	Description
id	Unique Twitter user ID
name	Display name
username	Handle (e.g. wavpost)
picture	Profile image URL

3. Publishing tweets

Publish tweets with text. Media uploads (photos, videos) are available via the media.write scope.

POST/api/v1/postsPublish a tweet

curl -X POST https://api.wavpost.com/api/v1/posts \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Shipping social features in minutes. 🚀",
    "platforms": ["twitter"]
  }'

Response 201

{
  "id": "post-uuid",
  "status": "published",
  "platformResults": {
    "twitter": {
      "ok": true,
      "platformPostId": "1856234567890123456"
    }
  }
}

4. Limits & notes

Constraint	Value
Max text length	280 characters
Media upload	Photos and videos (media.write)
Likes	Read and write (like.read, like.write)
Follows	Read and write (follows.read, follows.write)
Bookmarks	Read and write (bookmark.read, bookmark.write)
Direct Messages	Read and send (dm.read, dm.write)
Hide replies	Supported (tweet.moderate.write)
Access token expiry	2 hours (auto-refreshed via offline.access)
Auth method	OAuth 2.0 PKCE
Credit cost	3 credits per tweet

YouTube

Current access

Scopes: youtube.upload youtube.readonly openid profile — supports video uploads and community text posts.

1. Connect a YouTube channel

GET/api/auth/youtubeStart YouTube OAuth

Parameters

Name	Type	Description
profileId	string	Query param. Which profile to connect the account to. Uses default if omitted.

# Open in browser
https://api.wavpost.com/api/auth/youtube?profileId=your-profile-id

2. Profile data returned

Field	Description
id	YouTube channel ID
displayName	Channel name
picture	Channel thumbnail URL

3. Publishing

WavPost auto-detects the post type based on mediaUrls: if a video URL is present it uploads a video; otherwise it creates a community post.

Video upload

Pass a direct video URL in mediaUrls. The first line of text becomes the video title (max 100 chars); the full text becomes the description.

curl -X POST https://api.wavpost.com/api/v1/posts \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "My video title\nFull description goes here.",
    "platforms": ["youtube"],
    "mediaUrls": ["https://your-cdn.com/video.mp4"]
  }'

Community post (text)

Requires 500+ subscribers on the connected channel.

curl -X POST https://api.wavpost.com/api/v1/posts \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Check out our latest update!",
    "platforms": ["youtube"]
  }'

Response 201

// Video upload
{
  "platformResults": {
    "youtube": {
      "ok": true,
      "platformPostId": "https://youtube.com/watch?v=dQw4w9WgXcQ"
    }
  }
}

// Community post
{
  "platformResults": {
    "youtube": {
      "ok": true,
      "platformPostId": "Ug_community_post_id"
    }
  }
}

4. Limits & notes

Constraint	Value
Video formats	mp4, mov, avi, mkv, webm, flv, wmv (public URL required)
Video title	First line of text, max 100 characters
Video visibility	Public
Video category	People & Blogs (categoryId: 22)
Community posts	Requires 500+ subscribers
Access token expiry	1 hour (refresh token issued automatically)
Auth method	OAuth 2.0 (Google)
Credit cost	1 credit per post

Platforms

Platform	ID	Text	Images	Auth method
LinkedIn	linkedin	✓	Up to 9	OAuth 2.0
Twitter / X	twitter	✓	—	OAuth 2.0 PKCE
YouTube	youtube	✓	—	OAuth 2.0

AI Agents

Two machine-readable formats are available for AI agents and OpenAPI toolchains.

🤖

llms.txt

Plain-text API reference for LLMs. Feed this to any AI agent to give it full knowledge of the API.

/llms.txt →

⚙️

OpenAPI 3.0

Machine-readable spec. Works with LangChain, CrewAI, OpenAI function calling, and any OpenAPI toolchain.

/openapi.json →

# 1. Fetch the API reference for your agent
curl https://api.wavpost.com/llms.txt

# 2. Agent calls the API
curl -X POST https://api.wavpost.com/api/v1/posts \
  -H "Authorization: Bearer sk_live_agent_key" \
  -H "Content-Type: application/json" \
  -d '{"text": "Agent-generated post!", "platforms": ["linkedin"]}'

Errors

All errors return a JSON body with an error field.

{ "error": "Missing or invalid 'text' (string)" }

Status	Meaning
200	Success
201	Resource created successfully
400	Bad request — missing or invalid fields
401	Unauthorized — missing, invalid, or revoked token
404	Not found — profile or platform does not exist