REST API

Bring social media publishing into your code.

Publish your images or videos on your connected accounts with one request, generate on-brand visuals with Envox AI, read how every post did and send WhatsApp templates to your customers. For your CMS, your store or your automation tools.

Use it with:n8nMakeZapierPythonNode.jsPHP
POST /v1/posts
curl -X POST https://app.envox.ai/api/v1/posts \
  -H "Authorization: Bearer envx_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "caption": "New collection is live ✨ #envox",
    "media_urls": ["https://example.com/photo.jpg"],
    "social_account_ids": [12],
    "scheduled_at": "2026-12-01T09:30:00+03:00"
  }'
201 Created
{
  "data": {
    "id": 1842,
    "status": "scheduled",
    "format": "image",
    "scheduled_at": "2026-12-01T06:30:00+00:00",
    "targets": [
      {
        "social_account_id": 12,
        "platform": "instagram",
        "status": "pending"
      }
    ]
  }
}

A simple, predictable API

The same publishing flow as the panel; send JSON, get JSON.

One-key authentication

An Authorization: Bearer header is all it takes. Create keys in the panel and revoke them any time.

Now, later or draft

Schedule with scheduled_at, keep it for approval with draft; times without an offset are read in your account timezone.

Images and video

Pass files as links or upload them. PNG and WebP are converted to Instagram-ready JPEG automatically; MP4 and MOV videos go out as Reels.

Envox AI content

Images, carousels and Reel videos from a topic, in your brand guide style. Poll the generation and publish the result.

Post statistics

Likes, comments, reach, views and saves per post, and a 30 day summary for every account.

WhatsApp Business

AI-written templates, template sends to thousands of numbers with delivery reports, and the inbox.

Per-account results

Each post’s status, error and network post id on every account, in one response.

Team permissions

Keys are limited to the panel permissions of the user who created them.

Clear errors

Every error has the same shape; insufficient credits is 402, validation 422, rate limit 429.

Endpoints

Posts, Envox AI, ideas and statistics, and WhatsApp. All JSON, all with the same authentication.

Base URL

https://app.envox.ai/api/v1

All parameters and examples

Account, media and posts

GET

/me

The key’s account, timezone, credit balance and prices

GET

/social-accounts

Connected accounts you can publish to

POST

/media

Upload an image or a video (file or URL)

POST

/media/upload-links

One-time upload link

POST

/posts

Create a post: now, scheduled or draft

GET

/posts

List posts by status and date

GET

/posts/{id}

A post and its per-account result

PATCH

/posts/{id}

Change the caption or the time

POST

/posts/{id}/publish

Publish or schedule a draft

POST

/posts/{id}/cancel

Turn a scheduled post back into a draft

DELETE

/posts/{id}

Delete a draft

Envox AI

GET

/brand-guides

Brand guides AI images follow

POST

/images/generate

Generate images or a carousel from a topic

POST

/images/edit

A changed copy of an image

POST

/videos/generate

Turn an image into a Reel video

GET

/generations/{id}

Progress and result of a generation

Ideas and performance

GET

/posts/{id}/insights

Statistics of a post on each account

GET

/social-accounts/{id}/insights

An account over the last 30 days

GET

/suggestions

Post ideas

POST

/suggestions/generate

Generate new post ideas

GET

/competitors

Competitor accounts the ideas learn from

WhatsApp Business

GET

/whatsapp/templates

Templates and their review status

POST

/whatsapp/templates/draft

AI-written template draft

POST

/whatsapp/templates

Submit a template to Meta

POST

/whatsapp/sends

Send a template to many numbers

GET

/whatsapp/sends/{id}

Delivery report of a send

GET

/whatsapp/conversations

Customer conversations

POST

/whatsapp/conversations/{id}/reply

Reply within the 24 hour window

Your first post in five minutes

1

Create a key

Create an API key on the API & MCP page in the panel. It is shown only once.

2

Get your accounts

Find the ids of the accounts you want to post to.

curl https://app.envox.ai/api/v1/social-accounts \
  -H "Authorization: Bearer envx_YOUR_API_KEY"
3

Create the post

Send the images or the video, the caption and the accounts. Without scheduled_at it is published right away.

curl -X POST https://app.envox.ai/api/v1/posts \
  -H "Authorization: Bearer envx_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "caption": "New collection is live ✨ #envox",
    "media_urls": ["https://example.com/photo.jpg"],
    "social_account_ids": [12],
    "scheduled_at": "2026-12-01T09:30:00+03:00"
  }'

Pay only for what Envox does

Publishing content you made yourself costs a small credit per account it goes to. Envox AI images and videos are charged when they are made and publish at no extra cost; WhatsApp templates per sent message. Drafts, scheduling, statistics and reading are free.

—

per post, per account

AI image
—
AI video
—
WhatsApp message
—
See plans →

Prefer no code?

Connect an AI assistant such as Claude or Cursor over MCP and publish by chatting.

Explore MCP

Make your first API call today

Create a free account, connect your accounts and WhatsApp number, and make your key.