Instagram

Publish an Instagram post

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

POST

/api/v1/instagram/posts

Request bodyrequired

connectedAccountIdrequired

string · uuid

Connected account to act as

textrequired

string

Caption for the post. Write @username to mention someone.

mediarequired

object[]

Images or videos to publish.

postTypeoptional

"feed" | "story"

Defaults to feed. A story is visible for 24 hours.

locationoptional

string

Name of a place to tag.

Response

201Published post.

result

object

postId

string | null

createdAt

string · date-time

remainingToday

integer

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

Search docs

Search documentation, API reference, and MCP tools

We use cookies to enhance your experience on Needle and keep your data secure. Privacy Policy