Overview
What Instagram API does
If your team produces creative outside NexlerAI, the Instagram API lets you deliver it straight into the Content Planner.
Create a content-plan entry with a title, content type, media URL, caption and hashtags. Setting scheduledAt marks it SCHEDULED; leaving it empty keeps it as a DRAFT.
When it is ready, publish the entry to the connected Instagram account immediately.
Step by step
How it works
- 1
Create an instagram-scoped key
In Settings → Developer API keys.
- 2
Create a draft
POST /api/instagram/content-plans with media and caption.
- 3
Review in the planner
The draft appears in the Content Planner for your team.
- 4
Publish
POST /api/instagram/content-plans/:id/publish.
In the product
See it in action
Sample data shown for illustration.
Sample data shown for illustration.
Reference
Endpoints
/api/instagram/content-plansList all content-plan entries (draft, scheduled and published).
/api/instagram/content-plansCreate a draft. Setting scheduledAt marks it SCHEDULED instead of DRAFT.
/api/instagram/content-plans/:id/publishPublish a draft to the connected Instagram account immediately.
POST /api/instagram/content-plans
Authorization: Bearer nxk_live_your_key_here
{
"title": "Monsoon collection teaser",
"contentType": "Reel",
"mediaUrl": "https://your-cdn.example.com/teaser.mp4",
"mediaKind": "VIDEO",
"caption": "Layer up before the rain does.",
"hashtags": ["monsoonready", "layeringseason"],
"scheduledAt": "2026-07-01T09:30:00.000Z"
}
# 200 → { "success": true, "data": { "_id": "…", "status": "SCHEDULED" } }Before you start
Good to know
- Media must be reachable at a public URL.
- Publishing depends on the permissions of the connected Instagram account.
Nexlerate Technologies Pvt LtdParent company, NexlerAI
Nexlerate Technologies Pvt Ltd is the parent company and engineering team behind NexlerAI. The company builds on the official WhatsApp Cloud API, Meta’s Instagram and Messenger platforms, and the Shopify app ecosystem, and writes these guides from how the product works today.