---
title: PostNitro Embed API - Automate Carousel Creation
description: Integrate PostNitro's AI-powered carousel generation into your workflows. Automate social media content creation with our REST API for marketing agencies and developers.
canonical: https://postnitro.ai/docs/embed/api
---

# Welcome to PostNitro.ai Embed API

## Quick Reference

| | |
|---|---|
| **Base URL** | `https://embed-api.postnitro.ai` |
| **Authentication** | `embed-api-key: <your-api-key>` header on every request ([how to get a key](https://postnitro.ai/docs/embed/obtaining-an-api-key)) |
| **Content type** | `Content-Type: application/json` |
| **Output formats** | `PNG` (one image URL per slide) or `PDF` (single document URL) |
| **Processing model** | Asynchronous — initiate, poll status, then fetch output |
| **OpenAPI spec** | [https://postnitro.ai/docs/openapi.json](https://postnitro.ai/docs/openapi.json) |
| **Using an AI assistant?** | Connect the [PostNitro MCP server](https://postnitro.ai/docs/embed/mcp) instead — same key and credits, no manual API calls |
| **Scheduling** | Plan, draft & publish posts to LinkedIn, Instagram, TikTok, and Threads — see the [Schedule API](https://postnitro.ai/docs/embed/api/schedule) |

### Carousel Endpoints

| Method | Endpoint | Purpose |
|--------|----------|---------|
| POST | [`/post/initiate/generate`](https://postnitro.ai/docs/embed/api/initiate/generate) | Create a carousel using AI (from a topic/text, article URL, or X post URL) |
| POST | [`/post/initiate/import`](https://postnitro.ai/docs/embed/api/initiate/import) | Create a carousel from your own slide content |
| GET | [`/post/status/{embedPostId}`](https://postnitro.ai/docs/embed/api/request-status) | Check generation status (`PENDING`, `COMPLETED`, `FAILED`) |
| GET | [`/post/output/{embedPostId}`](https://postnitro.ai/docs/embed/api/post-output) | Retrieve the generated PNG/PDF files once `COMPLETED` |

### Scheduling Endpoints

Plan, draft, update, and delete social posts across LinkedIn, Instagram, TikTok, and Threads. See the [Schedule API](https://postnitro.ai/docs/embed/api/schedule) for authentication, request bodies, and per-platform settings.

| Method | Endpoint | Purpose |
|--------|----------|---------|
| GET | [`/schedule`](https://postnitro.ai/docs/embed/api/schedule/list-scheduled-posts) | List scheduled posts in a date range |
| POST | [`/schedule`](https://postnitro.ai/docs/embed/api/schedule/create-scheduled-post) | Create a scheduled post or draft |
| GET | [`/schedule/{id}`](https://postnitro.ai/docs/embed/api/schedule/get-scheduled-post) | Fetch a single scheduled post |
| PUT | [`/schedule/{id}`](https://postnitro.ai/docs/embed/api/schedule/update-scheduled-post) | Update a scheduled post |
| DELETE | [`/schedule/{id}`](https://postnitro.ai/docs/embed/api/schedule/delete-scheduled-post) | Delete a scheduled post |

### End-to-End Workflow

Every carousel follows the same three steps:

```bash
# 1. Initiate (returns an embedPostId; generation runs in the background)
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",
    "presetId": "your-ai-preset-id",
    "responseType": "PNG",
    "aiGeneration": {
        "type": "text",
        "context": "Create a LinkedIn carousel about digital marketing tips"
    }
}'
# => { "success": true, "data": { "embedPostId": "post123", "status": "PENDING" } }

# 2. Poll status until it is COMPLETED
curl --location 'https://embed-api.postnitro.ai/post/status/post123' \
--header 'embed-api-key: your-api-key'

# 3. Fetch the output (URLs of the generated files)
curl --location 'https://embed-api.postnitro.ai/post/output/post123' \
--header 'embed-api-key: your-api-key'
```

Required IDs (`templateId`, `brandId`, `presetId`) come from your PostNitro dashboard — set up your brand, templates, and AI presets at [PostNitro.ai](https://postnitro.ai) first.

## Why Use the PostNitro Embed API?

The PostNitro Embed API allows you to **automate your carousel post creation** and integrate it seamlessly into your existing workflows. Whether you're a marketing agency, content creator, or business looking to scale your social media presence, our API provides the tools you need.

### Perfect for Automation
- **Make.com (Integromat)**: Create automated workflows that generate posts based on triggers
- **Zapier**: Connect PostNitro to 5000+ apps and automate your content creation
- **n8n**: Build custom automation workflows for your specific needs
- **Custom Applications**: Integrate directly into your own software or platforms

### Use Cases

#### 1. **Content Marketing Automation**
- Generate weekly LinkedIn carousels automatically
- Create content based on trending topics
- Schedule posts in advance with dynamic content

#### 2. **Agency Workflows**
- Bulk generate carousel posts for multiple clients
- Maintain consistent branding across all client accounts
- Scale content creation without increasing manual work

#### 3. **Social Media Management**
- Create posts from blog content automatically
- Generate educational content from existing materials
- Maintain consistent posting schedules

#### 4. **E-commerce Marketing**
- Create product showcase carousels
- Generate promotional content for sales
- Build brand awareness campaigns

## How It Works

### 1. **AI Generation Workflow**
```mermaid
graph LR
    A[Your Content/Context] --> B[AI Processing]
    B --> C[Template Application]
    C --> D[Brand Integration]
    D --> E[Final Carousel]
```

### 2. **Import Workflow**
```mermaid
graph LR
    A[Your Slide Content] --> B[Template Application]
    B --> C[Brand Integration]
    C --> D[Final Carousel]
```

## API Capabilities

### Two Generation Methods

#### 1. **AI-Powered Generation**
- Provide a topic or context
- AI generates complete carousel content
- Multiple AI models available (GPT-3, GPT-4, GPT-4o, Claude models)
- Customizable tone, audience, and language settings

#### 2. **Manual Content Import**
- Provide your own slide content
- Full control over headings, descriptions, and images
- Perfect for existing content or specific messaging

### Output Formats
- **PNG**: Individual images for each slide (perfect for social media)
- **PDF**: Single document with all slides (great for presentations)

### Brand Integration
- Automatic branding with your logo and company information
- Customizable brand placement and styling
- Consistent brand identity across all generated content

## Getting Started

### 1. **Sign Up for PostNitro.ai**
- Create your account at [PostNitro.ai](https://postnitro.ai)
- Set up your brand profile and templates
- Configure your AI presets for consistent content generation

### 2. **Get Your API Key**
- Navigate to your account settings
- Generate an Embed API key
- Keep your API key secure and never share it publicly

### 3. **Choose Your Plan**

#### Free Plan
- **Price**: $0/month
- **Credits**: 5 per month

#### Monthly Plan
- **Price**: $10/month
- **Credits**: 250 per month

> 1 credit equals a single slide/image
> Creating post using user provided content costs 1 credit per slide
> AI generation costs 2x credit

### 4. **Start Automating**

#### Example: Daily LinkedIn Post Automation
```bash
# Generate a carousel post 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",
    "presetId": "your-ai-preset-id",
    "responseType": "PNG",
    "aiGeneration": {
        "type": "text",
        "context": "Create a LinkedIn carousel about digital marketing tips for small businesses",
        "instructions": "Focus on actionable tips that can be implemented immediately"
    }
}'
```

#### Example: Content Import Automation
```bash
# Import your own content
curl --location 'https://embed-api.postnitro.ai/post/initiate/import' \
--header 'Content-Type: application/json' \
--header 'embed-api-key: your-api-key' \
--data '{
    "postType": "CAROUSEL",
    "templateId": "your-template-id",
    "brandId": "your-brand-id",
    "responseType": "PNG",
    "slides": [
        {
            "type": "starting_slide",
            "heading": "Your Custom Title",
            "description": "Your custom description",
            "image": "https://your-image-url.com/image.jpg"
        }
    ]
}'
```

## Integration Examples

### Make.com (Integromat) Scenario
1. **Trigger**: New blog post published
2. **Action**: Generate carousel post using PostNitro API
3. **Action**: Upload to LinkedIn via LinkedIn API
4. **Action**: Schedule post for optimal time

### Zapier Scenario
1. **Trigger**: New item in Google Sheets (content calendar)
2. **Action**: Generate carousel post using PostNitro API
3. **Action**: Save generated images to Google Drive
4. **Action**: Send notification to team via Slack

### n8n Scenario
1. **Trigger**: RSS feed update (industry news)
2. **Action**: Analyze content and generate relevant carousel
3. **Action**: Post to multiple social platforms
4. **Action**: Track engagement metrics

## Best Practices

### 1. **Content Strategy**
- Use AI generation for educational and thought leadership content
- Use manual import for promotional and brand-specific content
- Mix both approaches for a balanced content strategy

### 2. **Automation Tips**
- Set up different AI presets for different content types
- Use requestorId to track which automation generated each post
- Monitor your usage to stay within plan limits

### 3. **Brand Consistency**
- Create multiple brand profiles for different campaigns
- Use consistent templates across similar content types
- Maintain your brand colors and fonts across all posts

### 4. **Performance Optimization**
- Use PNG format for social media (better quality)
- Use PDF format for presentations and documentation
- Monitor generation times and optimize your workflows

## Support and Resources

### Getting Help
- **Email Support**: [support@postnitro.ai](mailto:support@postnitro.ai)
- **Live Chat**: Send us a message on our live chat on [postnitro.ai](https://postnitro.ai)

### Rate Limits
- All endpoints are rate-limited to ensure fair usage
- Limits are per API key and vary by plan
- Monitor your usage in your PostNitro dashboard

## Ready to Get Started?

1. **Sign up** at [PostNitro.ai](https://postnitro.ai)
2. **Set up** your brand and templates
3. **Get your API key** from your account settings
4. **Start automating** your carousel post creation

Transform your social media strategy with AI-powered carousel posts. Start automating today! 🚀