Skip to Content
DeveloperPostnitro Embed

PostNitro Embed

PostNitro Embed provides three powerful ways to integrate our AI-powered carousel and image maker into your applications — create carousels (multi-slide) or image posts (single slide), optionally add AI-generated images, and schedule the results straight to social media:

  1. Embed SDK - A JavaScript library for embedding the carousel maker directly into your web application
  2. Embed APIs - REST APIs for automating carousel/image creation, scheduling, and integrating with your workflows
  3. MCP Server - A Model Context Protocol  server that lets AI assistants like Claude and Cursor create, schedule, and manage posts directly

For AI agents and LLMs: This documentation is available in plain-markdown form. Fetch https://postnitro.ai/docs/llms.txt  for a structured index, https://postnitro.ai/docs/llms-full.txt  for the complete documentation in a single file, or append .md to any docs page URL (e.g. https://postnitro.ai/docs/embed/api.md) for that page as raw markdown. To create carousels directly, connect the PostNitro MCP server at https://mcp.postnitro.ai/mcp.

Choose Your Integration Method

🎨 Embed SDK

Perfect for applications where you want to provide a visual interface for users to create and edit carousels directly within your website.

Key Capabilities:

  • Embeddable Interface: Seamlessly embed the carousel maker into your website
  • Create and Edit Carousels: Allow your users to create and edit carousels directly from your website
  • Real-time Preview: Users can see their changes instantly
  • Custom Branding: Apply your brand colors, fonts, and templates

Best for:

  • Content management systems
  • Marketing platforms
  • Social media tools
  • Educational platforms
  • Any application where users need visual control

⚡ Embed APIs

Perfect for automation, bulk operations, and integrating carousel creation into your existing workflows.

Key Capabilities:

  • AI-Powered Generation: Generate carousels or single-image posts from topics, articles, or text using AI
  • Content Import: Import your own slide content with full control
  • AI Image Generation: Optionally have AI generate images and bake them into the design (generateImages)
  • Multiple Output Formats: Get PNG images, PDF documents, or a saved design (DESIGN) with no render
  • Direct Scheduling: Schedule posts to LinkedIn, Instagram, TikTok, and Threads via the Schedule API
  • Automation Ready: Integrate with Make.com, Zapier, n8n, and custom applications

Best for:

  • Marketing automation
  • Content marketing workflows
  • Agency operations
  • Social media management
  • E-commerce marketing
  • Custom integrations

🤖 MCP Server

Perfect for AI assistants and agents. Connect once and your assistant can browse your templates, generate carousels, and fetch the finished files — conversationally.

Key Capabilities:

  • 28 Built-in Tools: Carousel and image generation/import, template/brand/preset discovery, status and output retrieval, brands, social accounts, and scheduling
  • One-Call Convenience: generate_and_wait, import_and_wait, and the image equivalents handle polling for you
  • Works Everywhere: Claude Desktop, Claude Code, Cursor, and any Streamable HTTP MCP client
  • Same Credits & Key: Uses your existing Embed API key and credit balance

Best for:

  • Claude, Cursor, and other AI assistant users
  • Custom AI agents and agentic workflows
  • Conversational content creation

Content Scheduling

Beyond creating designs, Embed lets you schedule posts to connected social accounts — no separate tool required. Scheduling is available both programmatically (Embed API) and conversationally (MCP Server).

What you can do:

  • Schedule or draft posts to your connected accounts on a future date/time, or save them as drafts.
  • Attach a design by its designId (returned by any create call) and set per-platform captions and settings.
  • Manage the queue — list, fetch, update, and delete scheduled posts.
  • Connect accounts — list and manage the social accounts posts are published to.

Supported platforms: LinkedIn (profiles & organizations), Instagram, TikTok, and Threads.

How to use it:

  • Embed API — full CRUD via the Schedule API. Create a design, then attach its designId to a scheduled post.
  • MCP Server — scheduling tools (postnitro_create_scheduled_post, postnitro_list_scheduled_posts, and others), plus the one-call postnitro_generate_and_schedule that generates and schedules in a single step.

Tip: Scheduling resolves a design by its designId, not the embedPostId of the generation job — see carousel identifiers.

Getting Started

For Embed SDK

  1. Get an API Key: Sign up at PostNitro.ai  and get your API key
  2. Install the SDK: Follow our installation guide
  3. Initialize: Set up the SDK in your application
  4. Start Creating: Let your users create carousels directly in your app

For Embed APIs

  1. Get an API Key: Sign up at PostNitro.ai  and get your Embed API key
  2. Choose Your Method: Use AI generation or content import
  3. Make API Calls: Start automating your carousel creation
  4. Integrate: Connect with your favorite automation tools

For MCP Server

  1. Get an API Key: Sign up at PostNitro.ai  and get your Embed API key
  2. Connect: Add https://mcp.postnitro.ai/mcp to your MCP client with your key — see the setup guide
  3. Create & Schedule: Ask your AI assistant to generate carousels or image posts — and schedule them for you

Pricing

Is it free?

  • Embed SDK: Free to use and embed, but you need an API key
  • Embed APIs: Free plan available with 5 credits per month

API Pricing Plans

Free Plan

  • Price: $0/month
  • Credits: 5 per month

Monthly Plan

  • Price: $10/month
  • Credits: 250 per month

Credit Usage:

  • 1 credit = 1 slide/image
  • Content import: 1 credit per slide
  • AI generation: 2 credits per slide
  • AI image generation (generateImages) bills against a separate organization AI-image quota — it does not change a post’s slide-based credit count (and isn’t available on the free plan)

Use Cases

Embed SDK Use Cases

  • Content Management Systems: Let users create carousels for their content
  • Marketing Platforms: Provide visual carousel creation tools
  • Educational Platforms: Enable students to create educational content
  • Social Media Tools: Allow users to design posts before publishing

Embed API Use Cases

  • Content Marketing Automation: Generate weekly LinkedIn carousels automatically
  • Agency Workflows: Bulk generate carousel posts for multiple clients
  • Scheduled Publishing: Generate designs and schedule them to social accounts on a content calendar
  • Social Media Management: Create posts from blog content automatically
  • E-commerce Marketing: Create product showcase carousels and image posts
  • Custom Integrations: Build your own automation workflows

Integration Examples

SDK Integration

// Initialize the PostNitro SDK
import { createEditor } from "@postnitro/embed";
 
const editor = createEditor({
    apiKey: "your-api-key"
});
 
// Open the carousel maker to create a new design
editor.createDesign((data) => {
    console.log('Carousel exported:', data);
    // data: { id, name, size, type, data: Blob | Blob[] }
});

API Integration

# Generate a carousel using AI
curl --location 'https://embed-api.postnitro.ai/post/initiate/generate' \
--header 'Content-Type: application/json' \
--header 'embed-api-key: your-api-key' \
--data '{
    "postType": "CAROUSEL",
    "templateId": "your-template-id",
    "brandId": "your-brand-id",
    "aiGeneration": {
        "type": "text",
        "context": "Create a LinkedIn carousel about digital marketing tips"
    }
}'

MCP Integration

// Add to your MCP client configuration (Claude Desktop, Cursor, etc.)
{
  "mcpServers": {
    "postnitro": {
      "type": "http",
      "url": "https://mcp.postnitro.ai/mcp",
      "headers": {
        "Authorization": "Bearer pn-your-api-key-here"
      }
    }
  }
}

Next Steps

For SDK Users

For API Users

For AI Agent Users

Support

Ready to get started? Choose your integration method and begin creating amazing carousel content!

Last updated on
Obtaining an API Key