> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Introduction

## Article: Introduction

## Article Link: https://dev.wix.com/docs/api-reference/business-management/marketing/social-media/item-v1/introduction.md

## Article Content:

# About the Items API

The Items API lets you create, publish, schedule, and manage social media posts on a site's connected channels. In this API, a post is called an item. Items you create through the API appear on the site's Social Media Marketing page in the dashboard, alongside posts created there manually.

With the Items API, you can:

- Create draft items and publish or schedule them for a future date.
- Publish a fully-formed item in a single call.
- Retrieve, update, and delete items.
- Query items to find drafts, scheduled posts, or published posts.
- Reschedule or cancel scheduled items.
- Publish multiple items in bulk.

Before publishing or scheduling, check that the target channel is connected with the [Accounts API](https://dev.wix.com/docs/api-reference/business-management/marketing/social-media/account-v1/introduction.md) and that the site has remaining quota with the [Premium Features API](https://dev.wix.com/docs/api-reference/business-management/marketing/social-media/premium-feature-v1/introduction.md). You can optionally generate post content with the [Generated Content API](https://dev.wix.com/docs/api-reference/business-management/marketing/social-media/generated-content-v1/introduction.md) before creating a draft.

## Item lifecycle

An item moves through statuses as you work with it:

- **Draft**: Created with [Create Draft Item](https://dev.wix.com/docs/api-reference/business-management/marketing/social-media/item-v1/create-draft-item.md) and not yet published or scheduled.
- **Scheduled**: Published with a future `scheduledDate`. The post is published automatically at that time unless you cancel or reschedule it.
- **Published**: Live on the connected channel.

The recommended flow is to create a draft first, then publish or schedule it with [Publish Item By ID](https://dev.wix.com/docs/api-reference/business-management/marketing/social-media/item-v1/publish-item-by-id.md). You can also call [Publish Item](https://dev.wix.com/docs/api-reference/business-management/marketing/social-media/item-v1/publish-item.md) with a complete item in one step.

## Before you begin

It's important to note the following points before starting to code:

- A site owner must connect their social channels in the site's dashboard before you can publish to them. See [Connecting to your social media accounts](https://support.wix.com/en/article/social-media-marketing-connect-to-your-social-media-accounts).
- Each item targets a single connected channel. Its `type` and content must match a combination that channel supports.
- Publishing and scheduling can fail if the site has reached its plan quota. Call [Get Feature Data](https://dev.wix.com/docs/api-reference/business-management/marketing/social-media/premium-feature-v1/get-feature-data.md) with `PUBLISH_POST` or `SCHEDULE_POST` before you publish or schedule.
- Posts created natively on a channel rather than through Wix are imported once a day for sites on a paid social media marketing plan. They appear as items with `external` set to `true` and may take up to a day to show up.

## Use cases

- [Create and publish a post](https://dev.wix.com/docs/api-reference/business-management/marketing/social-media/item-v1/sample-flows.md#create-and-publish-a-post).
- [Schedule a post for a future date](https://dev.wix.com/docs/api-reference/business-management/marketing/social-media/item-v1/sample-flows.md#schedule-a-post-for-a-future-date).
- [Reschedule or cancel a scheduled post](https://dev.wix.com/docs/api-reference/business-management/marketing/social-media/item-v1/sample-flows.md#reschedule-or-cancel-a-scheduled-post).
- [Generate post content and publish it](https://dev.wix.com/docs/api-reference/business-management/marketing/social-media/item-v1/sample-flows.md#generate-post-content-and-publish-it).
- [Generate a caption for a post](https://dev.wix.com/docs/api-reference/business-management/marketing/social-media/item-v1/sample-flows.md#generate-a-caption-for-a-post).

## Terminology

- **Item**: A social media post managed through the Publisher API. An item can be a draft, scheduled, or published post and targets a single connected channel.
- **Channel**: A social network that a post is published to, such as Instagram or TikTok.
- **Account**: A connected social channel, such as an Instagram business account or a Facebook page, that an item is published to.
- **Status**: Indicates whether an item is a draft, scheduled, or published.

@sdk_package_setup