---
name: Social Post Generator
description: Generate platform-optimized social media posts with optional images via the Nexus content job API
---

# Social Post Generator

Generate social media post copy and optional image assets sized for specific platforms. Respects character limits and platform conventions.

## Usage

Submit a content job via `POST /api/companies/{companyId}/content-jobs`:

```json
{
  "jobType": "social-post",
  "input": {
    "prompt": "Launch announcement for our new AI assistant feature",
    "platform": "twitter-x"
  }
}
```

**Fields:**
- `prompt` (required): The subject or message to communicate
- `platform` (optional): Target platform — `twitter-x`, `linkedin`, `instagram-caption`, `instagram-carousel` (default: `twitter-x`)

## Output

The job returns a `SocialPostBundle` with:
- `copy`: Post text body
- `hashtags`: Array of suggested hashtags
- `slides`: Optional carousel slide content array
- `platform`: The target platform applied
