> 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 # Package: socialMedia # Namespace: itemV1 # Webhook link: https://dev.wix.com/docs/api-reference/business-management/marketing/social-media/item-v1/item-published.md ## Introduction # Webhook Permissions Scopes IDs: --- ## REST API ### Schema ``` Webhook: Item Published Description: Event body: - name: id | type: string | description: Unique event ID. Allows clients to ignore duplicate events. - name: entityFqdn | type: string | description: Fully qualified domain name of the entity associated with the event. - name: slug | type: string | description: Event name. - name: entityId | type: string | description: ID of the entity associated with the event. - name: eventTime | type: string (date-time) | description: Event timestamp. - name: triggeredByAnonymizeRequest | type: boolean | description: Whether the event was triggered as a result of a privacy regulation application such as GDPR. - name: originatedFrom | type: string | description: If present, indicates the action that triggered the event. - name: actionEvent | type: object | description: Custom action event details. - name: body | type: ItemPublished | description: The event body. - name: item | type: Item | description: Published item. - ONE-OF: - name: instagramPost | type: InstagramPost | description: Instagram post content. - ONE-OF: - name: imageUrl | type: string | description: The image URL. - name: videoUrl | type: string | description: The video URL. - name: mediaWrapper | type: MediaWrapper | description: The media list. - name: media | type: array | description: List of media items. - name: type | type: MediaType | description: Media type. - enum: IMAGE, VIDEO - name: url | type: string | description: Media URL. - name: fileId | type: string | description: Media Manager file GUID backing the media. Available only when the media is stored in the Media Manager. - name: caption | type: string | description: Caption for the post. Can include hashtags (for example, `#crazywildebeest`) and mentions of Instagram users (for example, `@natgeo`). Mentioned users are notified when the post is published. Supports up to 30 hashtags and 20 mentions. - name: postUrl | type: string | description: The post URL on Instagram. - name: insights | type: InstagramInsights | description: Insights from Instagram. - name: likes | type: integer | description: Number of likes. - name: engagement | type: integer | description: Number of engagements. - name: impressions | type: integer | description: Number of impressions. - name: plays | type: integer | description: Number of plays. - name: reach | type: integer | description: Number of accounts reached. - name: comments | type: integer | description: Number of comments. - name: shares | type: integer | description: Number of shares. - name: saved | type: integer | description: Number of saves. - name: totalInteractions | type: integer | description: Total number of interactions. - name: instagramStory | type: InstagramStory | description: Instagram story content. - name: storyUrl | type: string | description: The story URL on Instagram. - name: mediaWrapper | type: MediaWrapper | description: The media list. - name: insights | type: InstagramStoryInsights | description: insights data from Instagram. - name: impressions | type: integer | description: Number of impressions. - name: reach | type: integer | description: Number of accounts reached. - name: replies | type: integer | description: Number of replies. - name: facebookPost | type: FacebookPost | description: Facebook post content. - ONE-OF: - name: imageUrl | type: string | description: The image URL. - name: videoUrl | type: string | description: The video URL. - name: link | type: string | description: The link URL. - name: mediaWrapper | type: MediaWrapper | description: The media list. - name: pageId | type: string | description: The page GUID to publish the post to. - name: caption | type: string | description: Caption for the post. - name: postUrl | type: string | description: The post URL on Facebook. - name: linkMetadata | type: LinkMetadata | description: Link preview metadata. Available only when the post contains a link. - name: thumbnailUrl | type: string | description: Thumbnail URL for the link preview. - name: title | type: string | description: Title for the link preview. - name: description | type: string | description: Description for the link preview. - name: insights | type: FacebookInsights | description: Insights from Facebook. - name: impressions | type: FacebookImpressions | description: Impression counts. - name: unique | type: integer | description: Number of unique impressions. - name: total | type: integer | description: Total number of impressions. - name: interactions | type: FacebookInteractions | description: Interaction counts. - name: unique | type: integer | description: Number of unique interactions. - name: total | type: integer | description: Total number of interactions. - name: reactions | type: FacebookReactions | description: Reaction counts. - name: like | type: integer | description: Number of "like" reactions. - name: love | type: integer | description: Number of "love" reactions. - name: wow | type: integer | description: Number of "wow" reactions. - name: haha | type: integer | description: Number of "haha" reactions. - name: sad | type: integer | description: Number of "sad" reactions. - name: anger | type: integer | description: Number of "angry" reactions. - name: activity | type: FacebokActivity | description: Activity counts. - name: share | type: integer | description: Number of shares. - name: like | type: integer | description: Number of likes. - name: comment | type: integer | description: Number of comments. - name: updatedDate | type: string | description: Date and time the insights were last updated. - name: facebookReel | type: FacebookReel | description: Facebook reel content. - name: pageId | type: string | description: The page GUID to publish the reel to. - name: videoUrl | type: string | description: The video URL. - name: description | type: string | description: A description for the reel. - name: insights | type: FacebookInsights | description: Insights from Facebook. - name: mediaWrapper | type: MediaWrapper | description: The media list. - name: facebookStory | type: FacebookStory | description: Facebook story content. - name: pageId | type: string | description: The page GUID to publish the story to. - name: storyUrl | type: string | description: The story URL on Facebook. - name: mediaWrapper | type: MediaWrapper | description: The media list. - name: insights | type: FacebookInsights | description: Insights from Facebook. - name: youtubeVideo | type: YouTubeVideo | description: YouTube video content. - name: channelId | type: string | description: The channel GUID to publish the video to. - name: videoUrl | type: string | description: The video URL. - name: title | type: string | description: A title for the video. - name: description | type: string | description: A description for the video. - name: categoryId | type: string | description: A category for the video. - name: notifySubscribers | type: boolean | description: Whether to notify channel subscribers when the video is published. - name: insights | type: YoutubeInsights | description: Insights data from YouTube. - name: views | type: integer | description: Number of views. - name: comments | type: integer | description: Number of comments. - name: likes | type: integer | description: Number of likes. - name: dislikes | type: integer | description: Number of dislikes. - name: shares | type: integer | description: Number of shares. - name: updatedDate | type: string | description: Date and time the insights were last updated. - name: mediaWrapper | type: MediaWrapper | description: The media list. - name: youtubeShort | type: YouTubeShort | description: YouTube short content. - name: channelId | type: string | description: The channel GUID to publish the short to. - name: videoUrl | type: string | description: The short URL. - name: title | type: string | description: A title for the short. - name: description | type: string | description: A description for the short. - name: categoryId | type: string | description: A category for the short. - name: notifySubscribers | type: boolean | description: Whether to notify channel subscribers when the short is published. - name: insights | type: YoutubeInsights | description: Insights data from YouTube. - name: mediaWrapper | type: MediaWrapper | description: The media list. - name: linkedinPost | type: LinkedinPost | description: LinkedIn post content. - ONE-OF: - name: imageUrl | type: string | description: The image URL. - name: videoUrl | type: string | description: The video URL. - name: link | type: string | description: The link URL. - name: mediaWrapper | type: MediaWrapper | description: The media list. - name: authorId | type: string | description: Author GUID of the post. Can be an organization page or a personal feed. - name: caption | type: string | description: Caption for the post. - name: linkMetadata | type: LinkMetadata | description: Link preview metadata. Available only when the post contains a link. - name: insights | type: LinkedinPostInsights | description: Insights from LinkedIn. - name: uniqueImpressions | type: integer | description: Number of unique impressions. - name: impression | type: integer | description: Total number of impressions. - name: shares | type: integer | description: Number of shares. - name: engagement | type: float | description: Engagement rate. - name: clicks | type: integer | description: Number of clicks. - name: likes | type: integer | description: Number of likes. - name: comments | type: integer | description: Number of comments. - name: updatedDate | type: string | description: Date and time the insights were last updated. - name: twitterPost | type: TwitterPost | description: X (Twitter) post content. - ONE-OF: - name: imageUrl | type: string | description: The image URL. - name: videoUrl | type: string | description: The video URL. - name: link | type: string | description: The link URL. - name: mediaWrapper | type: MediaWrapper | description: The media list. - name: caption | type: string | description: Caption for the post. - name: linkMetadata | type: LinkMetadata | description: Link preview metadata. Available only when the post contains a link. - name: insights | type: TwitterInsights | description: Insights from X (Twitter). - name: retweets | type: integer | description: Number of retweets. - name: replies | type: integer | description: Number of replies. - name: likes | type: integer | description: Number of likes. - name: quotes | type: integer | description: Number of quote posts. - name: bookmarks | type: integer | description: Number of bookmarks. - name: impressions | type: integer | description: Number of impressions. - name: updatedDate | type: string | description: Date and time the insights were last updated. - name: pinterestPost | type: PinterestPost | description: Pinterest post content. - name: boardId | type: string | description: The board GUID to publish the post to. - name: title | type: string | description: The title of the post. - name: description | type: string | description: The description of the post. - name: link | type: string | description: The link to include in the post. - name: mediaWrapper | type: MediaWrapper | description: The media list. - name: insights | type: PinterestInsights | description: Insights from Pinterest. - name: impressions | type: integer | description: Number of impressions. - name: clicks | type: integer | description: Number of clicks. - name: saves | type: integer | description: Number of saves. - name: comments | type: integer | description: Number of comments. - name: reactions | type: integer | description: Number of reactions. - name: updatedDate | type: string | description: Date and time the insights were last updated. - name: gbpPost | type: GbpPost | description: Google Business Profile post content. - name: locationId | type: string | description: The location GUID to publish the post to. - name: locationAccountId | type: string | description: Account (group) GUID of the location. - name: description | type: string | description: The description of the post. - name: callToAction | type: GbpPostCallToAction | description: Call to action type and URL to include in the post. - name: actionType | type: GbpPostCallToActionType | description: Type of the call to action. - enum: BOOK, ORDER, SHOP, LEARN_MORE, SIGN_UP - name: url | type: string | description: URL of the call to action. - name: mediaWrapper | type: MediaWrapper | description: The media list. - name: insights | type: GbpInsights | description: Insights from Google Business Profile. - name: shares | type: integer | description: Number of shares. Google Business Profile post insights aren't currently available, so this returns `-1`. - name: updatedDate | type: string | description: Date and time the insights were last updated. - name: tiktokVideo | type: TikTokVideo | description: TikTok video content. - name: accountId | type: string | description: The account GUID to publish the video to. - name: privacyLevel | type: TikTokPrivacyLevel | description: Privacy level for the video. - enum: PUBLIC_TO_EVERYONE, FOLLOWER_OF_CREATOR, MUTUAL_FOLLOW_FRIENDS, SELF_ONLY - name: description | type: string | description: A description for the video. - name: disableComment | type: boolean | description: Whether comments are disabled for the video. - name: disableDuet | type: boolean | description: Whether duets are disabled for the video. - name: disableStitch | type: boolean | description: Whether stitches are disabled for the video. - name: brandContentToggle | type: boolean | description: Whether the content is a paid partnership promoting a third-party business. - name: brandOrganicToggle | type: boolean | description: Whether the content promotes the creator's own business. - name: mediaWrapper | type: MediaWrapper | description: The media list. - name: insights | type: TikTokInsights | description: Insights from TikTok. - name: views | type: integer | description: Number of views. - name: likes | type: integer | description: Number of likes. - name: comments | type: integer | description: Number of comments. - name: shares | type: integer | description: Number of shares. - name: updatedDate | type: string | description: Date and time the insights were last updated. - name: tiktokPhoto | type: TikTokPhoto | description: TikTok photo content. - name: accountId | type: string | description: The account GUID to publish the photo to. - name: privacyLevel | type: TikTokPrivacyLevel | description: Privacy level for the photo. - enum: PUBLIC_TO_EVERYONE, FOLLOWER_OF_CREATOR, MUTUAL_FOLLOW_FRIENDS, SELF_ONLY - name: title | type: string | description: A title for the photo. - name: description | type: string | description: A description for the photo. - name: disableComment | type: boolean | description: Whether comments are disabled for the photo. - name: autoAddMusic | type: boolean | description: Whether to automatically add music to the photo. - name: brandContentToggle | type: boolean | description: Whether the content is a paid partnership promoting a third-party business. - name: brandOrganicToggle | type: boolean | description: Whether the content promotes the creator's own business. - name: mediaWrapper | type: MediaWrapper | description: The media list. - name: insights | type: TikTokInsights | description: Insights from TikTok. - name: id | type: string | description: Item GUID. - name: channel | type: Channel | description: Social channel the item is published to, and the account within that channel. - name: name | type: ChannelName | description: Social channel the item is published to. - enum: INSTAGRAM, FACEBOOK, YOUTUBE, LINKEDIN, TWITTER, PINTEREST, GBP, TIKTOK - name: accountId | type: string | description: GUID of the connected account the item is published to. - name: accountName | type: string | description: Display name of the connected account the item is published to. - name: externalItemId | type: string | description: GUID of the post on the social channel. Returned after the item is published. - name: externalItemUrl | type: string | description: URL of the post on the social channel. Returned after the item is published. - name: publishingTarget | type: PublishingTarget | description: Specific destination within the account, such as a Facebook page or a Pinterest board. - name: id | type: string | description: GUID of the publishing target. - name: displayName | type: string | description: Display name of the publishing target. - name: pictureUrl | type: string | description: URL of the publishing target's picture. - name: type | type: ItemType | description: Item format. The `type` and the content set in `data` must match a combination supported by the item's `channel.name`: - Instagram: `POST` with `instagramPost`, or `STORY` with `instagramStory`. - Facebook: `POST` with `facebookPost`, `REEL` with `facebookReel`, or `STORY` with `facebookStory`. - YouTube: `VIDEO` with `youtubeVideo`, or `SHORT` with `youtubeShort`. - LinkedIn: `POST` with `linkedinPost`. - X (Twitter): `POST` with `twitterPost`. - Pinterest: `POST` with `pinterestPost`. - Google Business Profile: `POST` with `gbpPost`. - TikTok: `POST` with `tiktokPhoto`, or `VIDEO` with `tiktokVideo`. - enum: - POST: A standard post. - REEL: A short-form vertical video reel. - VIDEO: A video. - SHORT: A short-form vertical video. - STORY: A story that's available for a limited time. - name: status | type: Status | description: Current status of the item in its lifecycle. - enum: - PUBLISHED: Published to the social channel. - SCHEDULED: Scheduled to be published at a future date. - CANCELED: Scheduling was canceled before the item was published. - FAILED: Publishing failed. - DELETED: Deleted. - PROCESSING: Publishing is in progress. - DRAFT: Saved as a draft, not yet published. - IN_QUEUE: Queued for publishing as part of a bulk operation. - name: publishedDate | type: string | description: Date and time the item was published. Returned only after the item is published. - name: schedulingInfo | type: SchedulingInfo | description: Scheduling info. Set to schedule the item for a future date instead of publishing it immediately. - name: scheduledDate | type: string | description: Date and time the item is scheduled to be published. - name: schedulingTimestamp | type: string | description: Date and time the item was scheduled. - name: referenceId | type: string | description: Caller-defined reference that uniquely identifies the item. Can be used to prevent duplicate publishing: an attempt to publish a second item with the same `referenceId` fails. Can also be used as a UTM campaign GUID. - name: siteAnalytics | type: SiteAnalytics | description: Aggregated analytics for the site, attributed to traffic from this post. - name: traffic | type: integer | description: Number of site sessions attributed to this post. - name: pageView | type: integer | description: Number of page views attributed to this post. - name: siteBounceRate | type: float | description: Site bounce rate attributed to this post. - name: revenue | type: float | description: Revenue attributed to this post. - name: conversionFunnel | type: ConversionFunnel | description: Conversion funnel data attributed to this post. - name: cartViewsSessions | type: integer | description: Number of sessions that viewed the cart. - name: checkOutSessions | type: integer | description: Number of sessions that reached checkout. - name: storeOrdersSessions | type: integer | description: Number of sessions that placed a store order. - name: bookingsConfirmed | type: integer | description: Number of confirmed bookings. - name: updatedDate | type: string | description: Date and time the insights were last updated. - name: insightsSummary | type: InsightsSummary | description: Summary of the post's performance on the social channel, such as impressions and interactions. - name: impressions | type: integer | description: Number of unique impressions (reach). - name: interactions | type: integer | description: Number of interactions, such as likes and comments. - name: updatedDate | type: string | description: Date and time the insights were last updated. - name: impressionsTotal | type: integer | description: Total number of impressions. - name: draftInfo | type: DraftInfo | description: Creation and update dates, returned for draft items. - name: createdDate | type: string | description: Date and time the draft was created. - name: updatedDate | type: string | description: Date and time the draft was updated. - name: suggested | type: boolean | description: Whether the item was generated as an AI suggestion. - name: external | type: boolean | description: Whether the item is a post created natively on the social channel rather than published through Wix. - name: publicationError | type: PublicationErrorDetails | description: Details of why the item failed to publish. Returned only when `status` is `FAILED`. - name: message | type: string | description: Error message shown when publishing fails. ``` ---