# Publish an Instagram post

### Publish an Instagram post

`POST /api/v1/instagram/posts`

Operation ID: `createInstagramPost`

Publishes a feed post or a story from the connected account. At least one image or video is required.

**Request body** (required)

- `connectedAccountId` (string · uuid, required): Connected account to act as
- `text` (string, required): Caption for the post. Write @username to mention someone.
- `media` (object[], required): Images or videos to publish.
- `postType` ("feed" | "story", optional): Defaults to feed. A story is visible for 24 hours.
- `location` (string, optional): Name of a place to tag.

**201**: Published post.

- `result` (object, required)
  - `postId` (string | null, required)
  - `createdAt` (string · date-time, required)
- `remainingToday` (integer, required): Remaining daily allowance for this action on the connected account. Each action type has its own limit.

**Errors**

- `400`: Bad request
- `401`: Unauthorized: missing or invalid API key
- `403`: Forbidden
- `404`: Not found
- `422`: Invalid request payload