Graph API Version

Page Post

A Post that was published on a Facebook Page.

Reading

A Post that has been published or is scheduled to be published on a Facebook Page.

Permissions

The source field will not be returned for Page-owned videos unless the User making the request is an admin of the owning Page.

Limitations

If a Post has expired, you will no longer be able to view the content using the Graph API.
This endpoint does not return Reels. To get a list of Reels published to your Page, use the Page VideoReels edge. See Reels Publishing API: Get a List of Reels for more information.

New Page Experience

This endpoint is supported for New Page Experience.

Feature Permissions

Name	Description
Page Public Content Access	This feature permission may be required.

Example

Graph API Explorer

GET /v23.0/{page-id}_{post-id}/ HTTP/1.1
Host: graph.facebook.com

/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->get(
    '/{page-id}_{post-id}/',
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */

/* make the API call */
FB.api(
    "/{page-id}_{post-id}/",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{page-id}_{post-id}/",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();

/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{page-id}_{post-id}/"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

curl -X GET -G \
  -d 'access_token=' \
  https://graph.facebook.com/v23.0/{page-id}_{post-id}/

If you want to learn how to use the Graph API, read our Using Graph API guide.

Parameters

This endpoint doesn't have any parameters.

Fields

Field	Description
`id` token with structure: Post ID	The post ID
`actions` list	Action links
`admin_creator` BusinessUser\|User\|Application	The admin creator of a Page Post. Only available if there exists more than one admin for the page.
`allowed_advertising_objectives` list	Objectives under which this post can be advertised
`application` Application	Information about the app this post was published by.
`backdated_time` datetime	The backdated time for backdate post. For regular post, this field will be set to null.
`call_to_action` struct with keys: type, value	The call to action type used in any Page posts for mobile app engagement ads.
`can_reply_privately` bool	Whether the page viewer can send a private reply to this post
`child_attachments` list	Sub-shares of a multi-link share post
`comments_mirroring_domain` string	If comments are being mirrored to an external site, this function returns the domain of that external site.
`coordinates` struct with keys: checkin_id, author_uid, page_id, target_id, target_href, coords, tagged_uids, timestamp, message, target_type	An array of information about the attachment to the post
`created_time` datetime	The time the post was published, expressed as UNIX timestamp Default
`event` Event	If this Post has a place, the event associated with the place
`expanded_height` unsigned int32	An array of information about the attachment to the post
`expanded_width` unsigned int32	An array of information about the attachment to the post
`feed_targeting` struct with keys: country, cities, regions, genders, age_min, age_max, education_statuses, college_years, relationship_statuses, interests, interested_in, user_adclusters, locales, countries, geo_locations, work_positions, work_employers, education_majors, education_schools, family_statuses, life_events, industries, politics, ethnic_affinity, generation, fan_of, relevant_until_ts	Object that controls Feed targeting for this post. Anyone in these groups will be more likely to see this post, others will be less likely, but may still see it anyway. Any of the targeting fields shown here can be used, none are required (applies to Pages only).
`from` User\|Page	The ID of the user, page, group, or event that published the post
`full_picture` string	Full size picture from attachment
`height` unsigned int32	An array of information about the attachment to the post
`icon` string	A link to an icon representing the type of this post.
`is_app_share` bool	Whether or not the post references an app
`is_eligible_for_promotion` bool	Whether the post is eligible for promotion.
`is_expired` bool	Whether the post has expiration time that has passed
`is_hidden` bool	Whether a post has been set to hidden
`is_inline_created` bool	Returns True if the post was created inline when creating ads.
`is_popular` bool	Whether the post is currently popular. Based on whether the total actions as a percentage of reach exceeds a certain threshold
`is_published` bool	Indicates whether a scheduled post was published (applies to scheduled Page Post only, for users post and instanlty published posts this value is always true)
`is_spherical` bool	Whether the post is a spherical video post
`message` string	The message written in the post Default
`message_tags` list	Profiles tagged in message. This is an object with a unique key for each tag in the message
`multi_share_end_card` bool	Whether display the end card for a multi-link share post
`multi_share_optimized` bool	Whether automatically select the order of the links in multi-link share post when used in an ad
`parent_id` token with structure: Post ID	The ID of a parent post for this post, if it exists. For example, if this story is a 'Your Page was mentioned in a post' story, the parent_id will be the original post where the mention happened
`permalink_url` uri	The permanent static URL to the post on www.facebook.com. Example: https://www.facebook.com/FacebookforDevelopers/posts/10153449196353553
`place` Place	ID of the place associated with the post
`privacy` Privacy	The privacy settings for a post
`promotable_id` token with structure: Post ID	ID of post to use for promotion for stories that cannot be promoted directly
`properties` list	A list of properties for any attached video, for example, the length of the video.
`scheduled_publish_time` float	UNIX timestamp of the scheduled publish time for the post
`shares` struct with keys: count	Number of times the post has been shared
`status_type` string	Description of the type of a status update.
`story` string	Text of stories not intentionally generated by users, such as those generated when two users become friends. You must have the "Include recent activity stories" migration enabled in your app to retrieve this field Default
`story_tags` list	The list of tags in the post description
`subscribed` bool	Whether user is subscribed to the post
`target` Profile	The profile this was posted on if different from the author
`targeting` struct with keys: country, cities, regions, zips, genders, college_networks, work_networks, age_min, age_max, education_statuses, college_years, college_majors, political_views, relationship_statuses, interests, keywords, interested_in, user_clusters, user_clusters2, user_clusters3, user_adclusters, excluded_user_adclusters, custom_audiences, excluded_custom_audiences, locales, radius, connections, excluded_connections, friends_of_connections, countries, excluded_user_clusters, adgroup_id, user_event, qrt_versions, page_types, user_os, user_device, action_spec, action_spec_friend, action_spec_excluded, geo_locations, excluded_geo_locations, targeted_entities, conjunctive_user_adclusters, wireless_carrier, site_category, work_positions, work_employers, education_majors, education_schools, family_statuses, life_events, behaviors, travel_status, industries, politics, markets, income, net_worth, home_type, home_ownership, home_value, ethnic_affinity, generation, household_composition, moms, office_type, interest_clusters_expansion, dynamic_audience_ids, product_audience_specs, excluded_product_audience_specs, exclusions, flexible_spec, engagement_specs, excluded_engagement_specs	Object that limited the audience for this content. Anyone not in these demographics will not be able to view this content. This will not override any Page-level demographic restrictions that may be in place.
`timeline_visibility` string	Timeline visibility information of the post
`updated_time` datetime	The time the post was last updated, which occurs when a user comments on the post.
`via` User\|Page	ID of the user or Page the post was shared from
`width` unsigned int32	An array of information about the attachment to the post

Edges

Edge	Description
`attachments` Edge	Any attachments that are associated with the story
`comments` Edge	Comments made on this
`dynamic_posts` Edge	All dynamic ad creatives
`insights` Edge	Insights for this post (only for Pages).
`likes` Edge	People who like this
`reactions` Edge	People who reacted on this
`sharedposts` Edge	Shared posts
`sponsor_tags` Edge	An array sponsor pages tagged in the post
`to` Edge	Profiles mentioned or targeted in this post.

Error Codes

Error	Description
100	Invalid parameter
200	Permissions error
190	Invalid OAuth 2.0 Access Token
368	The action attempted has been deemed abusive or is otherwise disallowed
80001	There have been too many calls to this Page account. Wait a bit and try again. For more info, please refer to https://developers.facebook.com/docs/graph-api/overview/rate-limiting.
2500	Error parsing graph query
283	That action requires the extended permission pages_read_engagement and/or pages_read_user_content and/or pages_manage_ads and/or pages_manage_metadata
3001	Invalid query

Creating

You can't perform this operation on this endpoint.

Updating

You can update a PagePost by making a POST request to /{page_post_id}.

Example

Graph API Explorer

POST /v23.0/{page-id}_{post-id}/ HTTP/1.1
Host: graph.facebook.com

message=This+is+a+test+value

/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->post(
    '/{page-id}_{post-id}/',
    array (
      'message' => 'This is a test value',
    ),
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */

/* make the API call */
FB.api(
    "/{page-id}_{post-id}/",
    "POST",
    {
        "message": "This is a test value"
    },
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

Bundle params = new Bundle();
params.putString("message", "This is a test value");
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{page-id}_{post-id}/",
    params,
    HttpMethod.POST,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();

NSDictionary *params = @{
  @"message": @"This is a test value",
};
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{page-id}_{post-id}/"
                                      parameters:params
                                      HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

curl -X POST \
  -F 'message="This is a test value"' \
  -F 'access_token=' \
  https://graph.facebook.com/v23.0/{page-id}_{post-id}/

If you want to learn how to use the Graph API, read our Using Graph API guide.

Parameters

Parameter	Description
`attached_media` list	attached_media
`media_fbid` numeric string
`message` UTF-8 string	Supports Emoji
`backdated_time` datetime	SELF_EXPLANATORY
`backdated_time_granularity` enum{year, month, day, hour, min, none}	Default value: `none` SELF_EXPLANATORY
`composer_session_id` string	composer_session_id
`direct_share_status` int64	The status to allow sponsor directly boost the post.
`explicitly_added_mentionee_ids` list	List of IDs that were explicitly mentioned by the user (i.e. typed) rather than auto-populated by the product.
`feed_story_visibility` enum{hidden, visible}	SELF_EXPLANATORY
`is_approved` boolean	SELF_EXPLANATORY
`is_explicit_location` boolean	is_explicit_location
`is_hidden` boolean	SELF_EXPLANATORY
`is_pinned` boolean	SELF_EXPLANATORY
`message` UTF-8 string	SELF_EXPLANATORY Supports Emoji
`og_action_type_id` numeric string or integer	SELF_EXPLANATORY
`og_hide_object_attachment` boolean	SELF_EXPLANATORY
`og_icon_id` numeric string or integer	SELF_EXPLANATORY
`og_object_id` OG object ID or URL string	SELF_EXPLANATORY
`og_phrase` string	SELF_EXPLANATORY
`og_set_profile_badge` boolean	og_set_profile_badge
`og_suggestion_mechanism` string	SELF_EXPLANATORY
`place` place tag	SELF_EXPLANATORY
`privacy` Privacy Parameter	SELF_EXPLANATORY
`product_item` Object	SELF_EXPLANATORY Supports Emoji
`title` string	Supports Emoji
`price` float
`currency` string	Default value: `USD`
`retail_price` float
`shipping_price` float
`condition` string	Default value: `used`
`description` string	Default value: Supports Emoji
`pickup_delivery_info` string	Default value:
`location_page_id` string	Default value:
`price_type` string	Default value: `fixed`
`multiple_item_type` string	Default value: `SINGLE_ITEM`
`category_id` numeric string or integer
`category_source` enum {TEXT, IMAGE, IMAGE_TEXT, IMAGE_TEXT_DOCNN, PAGE_ID, TITLE_REGEX, CLASSIFY_RULE, CATALOG_BERT_CLASSIFY_RULE, HUMAN_VERIFIED, SELLER_SELECTED, USE_EXISTING_PRODUCT, COMPOSER, HUMAN_MAPPING, PARTNER_INGESTION, MERCHANT_GOOGLE_CATEGORY, BUSINESS_DIRECT, MEGA_TAXON, SHOPS, MOTORS_ATTRIBUTES_C2C, CATALOG_BERT, CATALOG_BERT_ONLINE, ATTR_GENDER_F249720567, JOBS_TITLE_TAXONOMY_MAPPING, CATALOG_BERT_FULL_FPT, CATALOG_BERT_I18N, CATALOG_MMF_FULL_FPT, SCALE_AI, CATALOG_MMF_FULL_FPT_WITH_OVERRIDE}
`predict_category_id` numeric string or integer
`predict_leaf_category_id` numeric string or integer
`sherlock_image_model_signature` string	Default value:
`sherlock_model_id` integer	Default value: `0`
`sherlock_used_category_feature` enum {FAILED, TEXT_ONLY, IMAGE_ONLY, IMAGE_TEXT, USE_EXISTING_PRODUCT}
`latitude` float
`longitude` float
`quantity` int64
`serialized_verticals_data` string	Default value:
`commerce_verticals_data` Object
`autos_make` string
`autos_model` string
`autos_year` string
`autos_odometer` string
`autos_odometer_units` string	Default value:
`autos_vin` string
`draft_type` enum {COMMERCE_SELL_OPTIONS, FOR_SALE_AUTO, REAL_ESTATE}
`is_preview` boolean	Default value: `false`
`status_type` enum {COMMERCE_SELL_OPTIONS, COMMERCE_SELL_OPTIONS_HIDDEN, DRAFT}	Default value: `commerce_sell_options`
`original_commerce_item_id` numeric string or integer
`original_for_sale_item_id` numeric string or integer
`original_post_id` numeric string or integer
`original_product_item_id` numeric string or integer
`collection_id` numeric string or integer
`graphapi_has_photo_hint_for_loki` boolean	Default value: `false`
`shipping_offered` boolean	Default value: `false`
`delivery_type` enum {IN_PERSON, DROP_OFF}	Default value: `in_person`
`delivery_types` list
`shipping_services` list
`parcel_type` enum {USPS_LT_HALF_LBS, USPS_LT_THREE_LBS, USPS_LT_TEN_LBS, USPS_LT_TWENTY_LBS, OVERWEIGHT}
`seller_address_id` numeric string or integer
`seller_email` string	Default value:
`attribute_data` JSON object
`brand` string	Default value:
`color` string	Default value:
`size` string	Default value:
`material` string	Default value:
`condition` string	Default value:
`carrier` string	Default value:
`internal_memory` string	Default value:
`device_name` string	Default value:
`platform` string	Default value:
`decor_style` string	Default value:
`attribute_data_freeform` dictionary { numeric string or integer : }
`attribute_data_normalized` dictionary { numeric string or integer : > }
`variants` list
`id` numeric string or integer
`index` int64
`photo_ids` list
`product_image_ids` list
`price` float	Required
`description` string
`quantity` int64	Required
`additional_variant_attributes` list	Required
`variant_label` string	Default value:
`variant_value` string	Default value:
`commerce_shipping_delivery_type` enum {SHIPPING, LOCAL_DELIVERY, LOCKER}
`shipping_option_type` enum {PREPAID_LABEL, OWN_LABEL, LOCAL_DELIVERY}
`shipping_options_data` list
`shipping_price` JSON object
`currency` string	Default value: `USD`
`price` float	Required
`shipping_label_price` JSON object
`currency` string	Default value: `USD`
`price` float	Required
`shipping_label_rate_code` string
`shipping_cost_option` string
`commerce_shipping_carrier` enum {AUSTRALIA_POST, CANADA_POST, CDL_LASTMILE, DELIVER_IT, DHL, DHL_ECOMMERCE_US, EAGLE, FEDEX, FEDEX_UK, NEW_ZEALAND_POST, ONTRAC, POST_DANMARK, PUROLATOR, ROYAL_MAIL, SPEE_DEE, TFORCE_FINALMILE, TNT, TNT_POST, UPS, USPS, DOORDASH, DOORDASH_ARCHIVED, DPD_FRANCE, LA_POSTE, COLISSIMO, CHRONOPOST_FRANCE, TNT_FRANCE, COLIS_PRIVE, GEODIS_DISTRIBUTION_EXPRESS, BERT_TRANSPORT, GEODIS_E_SPACE, MONDIAL_RELAY, TELIWAY_SIC_EXPRESS, AMAZON, APC_OVERNIGHT, ARROW_XL, ASENDIA_UK, BIRDSYSTEM, BLUECARE_EXPRESS_LTD, COLLECT_PLUS, DELTEC_COURIER, DPD_LOCAL, DPD_LOCAL_REFERENCE, DPD_UK, HERMESWORLD, IMX_MAIL, JERSEY_POST, MYHERMES_UK, NATIONAL_SAMEDAY, NORSK_GLOBAL, PANTHER, PANDION, PANTHER_ORDER_NUMBER, PANTHER_REFERENCE, PARCEL_FORCE, RPD2MAN_DELIVERIES, TNT_UK, TNT_UK_REFERENCE, TUFFNELLS_PARCELS_EXPRESS, UK_MAIL, WHISTL, WNDIRECT, XDP_EXPRESS, XDP_EXPRESS_REFERENCE, YODEL_DOMESTIC, YODEL_INTERNATIONAL, AMAZON_LOGISTICS, AO_LOGISTICS, APC_OVERNIGHT_CONSIGNMENT_NUMBER, AQUILINE, BANDH_WORLDWIDE, CAE_DELIVERS, DHL_PARCEL_UK, DMSMATRIX, EU_FLEET_SOLUTIONS, GBA_SERVICES_LTD, GEMWORLDWIDE, KNAIRLINK_AEROSPACE_DOMESTIC_NETWORK, OCS_WORLDWIDE, PARCEL2GO, SKYNET_WORLDWIDE_EXPRESS_UK, TUFFNELLS_PARCELS_EXPRESS_REFERENCE, XPERT_DELIVERY, MAINWAY, INTERPARCEL_UK, UNIUNI, SDH, OTHER, ABF_FREIGHT, ABX_EXPRESS, AB_CUSTOM_GROUP, ACOMMERCE, ACS_COURIER, ACS_WORLDWIDE_EXPRESS, ADICIONAL_LOGISTICS, ADSONE, AIR21, AIRPAK_EXPRESS, AIRSPEED_INTERNATIONAL_CORPORATION, ALFATREX, ALLIED_EXPRESS, ALLJOY_SUPPLY_CHAIN_CO_LTD, ALPHAFAST, AMAZON_FBA_USA, AN_POST, APC_OVERNIGHT_REFERENCE, APC_POSTAL_LOGISTICS, APRISA_EXPRESS, ARAMEX, ASENDIA_GERMANY, ASENDIA_HK, ASENDIA_HK_PREMIUM_SERVICE_LATAM, ASENDIA_USA, ASM, AUPOST_CHINA, AUSTRALIA_POST_SFTP, AUSTRIAN_POST_EXPRESS, AUSTRIAN_POST_REGISTERED, AUPOST, DHLAU, AXLEHIRE, AXL_EXPRESS_LOGISTICS, A_DUIE_PYLE, A_J_EXPRESS, B2C_EUROPE, BELPOST, BEST_EXPRESS, BEST_WAY_PARCEL, BETTER_TRUCKS, BJS_DISTRIBUTION_STORAGE_COURIERS, BJS_DISTRIBUTION_STORAGE_COURIERS_FTP, BLUEDART, BLUE_STAR, BNEED, BONDS_COURIERS, BOXC, BPOST, BPOST_INTERNATIONAL, BRAZIL_CORREIOS, BRT_BARTOLINI, BRT_BARTOLINI_PARCEL_ID, BULGARIAN_POSTS, BUYLOGIC, CAINIAO, CAMBODIA_POST, CANPAR_COURIER, CAPITAL_TRANSPORT, CARRIER_007EX, CARRIER_17_POST_SERVICE, CARRIER_2GO, CARRIER_360_LION_EXPRESS, CARRIER_4PX, CARRIER_4_72_ENTREGANDO, CARRIER_ECHO, CBL_LOGISTICS, CELERITAS_TRANSPORTE_SL, CESKA_POSTA, CHINA_EMS_EPACKET, CHINA_POST, CHIT_CHATS, CHRONOPOST_PORTUGAL, CH_ROBINSON_WORLDWIDE_INC, CITY_LINK_EXPRESS, CJ_CENTURY, CJ_CENTURY_INTERNATIONAL, CJ_GLS, CJ_KOREA_EXPRESS, CJ_LOGISTICS_INTERNATIONAL, CJ_TRANSNATIONAL_PHILIPPINES, CLEVY_LINKS, CLOUDWISH_ASIA, CNE_EXPRESS, COLLECTCO, CON_WAY_FREIGHT, COPA_AIRLINES_COURIER, CORREOS_CHILE, CORREOS_DE_COSTA_RICA, CORREOS_DE_ESPANA, CORREOS_DE_MEXICO, CORREOS_EXPRESS, CORREO_ARGENTINO, COSMETICS_NOW, COUREX, COURIERPOST, COURIERS_PLEASE, COURIER_IT, COURIER_PLUS, CPACKET, CUCKOO_EXPRESS, CYPRUS_POST, DACHSER, DAWN_WING, DAYLIGHT_TRANSPORT_LLC, DB_SCHENKER, DB_SCHENKER_SWEDEN, DD_EXPRESS_COURIER, DELCART, DELHIVERY, DELIVERYONTIME_LOGISTICS_PVT_LTD, DEMANDSHIP, DETRACK, DEUTSCHE_POST_DHL, DEUTSCHE_POST_MAIL, DEX_I, DHL_2_MANN_HANDLING, DHL_ACTIVE_TRACING, DHL_BENELUX, DHL_ECOMMERCE_ASIA, DHL_EXPRESS_PIECE_ID, DHL_GLOBAL_FORWARDING, DHL_HONG_KONG, DHL_NETHERLANDS, DHL_PARCEL_NL, DHL_PARCEL_SPAIN, DHL_POLAND_DOMESTIC, DHL_SPAIN_DOMESTIC, DIMERCO_EXPRESS_GROUP, DIRECTLOG, DIRECT_FREIGHT_EXPRESS, DIRECT_LINK, DMM_NETWORK, DOORA_LOGISTICS, DOTZOT, DPD, DPD_GERMANY, DPD_HK, DPD_IRELAND, DPD_POLAND, DPD_ROMANIA, DPD_RUSSIA, DPEX, DPEX_CHINA, DPE_EXPRESS, DPE_SOUTH_AFRICA, DSV, DTDC_AUSTRALIA, DTDC_EXPRESS_GLOBAL_PTE_LTD, DTDC_INDIA, DX, DX_FREIGHT, DYNALOGIC_BENELUX_BV, DYNAMIC_LOGISTICS, EASY_MAIL, ECARGO, ECMS_INTERNATIONAL_LOGISTICS_CO_LTD, ECOM_EXPRESS, EC_FIRSTCLASS, EFS_E_COMMERCE_FULFILLMENT_SERVICE, EKART, ELTA_HELLENIC_POST, EMIRATES_POST, EMPS_EXPRESS, ENSENDA, ENVIALIA, EPARCEL_KOREA, EP_BOX, EQUICK_CHINA, ESTAFETA, ESTES, ETOTAL_SOLUTION_LIMITED, EURODIS, EXPEDITORS, EZSHIP, FASTRAK_SERVICES, FASTWAY_AUSTRALIA, FASTWAY_IRELAND, FASTWAY_NEW_ZEALAND, FASTWAY_SOUTH_AFRICA, FEDEX_CROSS_BORDER, FEDEX_FREIGHT, FEDEX_POLAND_DOMESTIC, FERCAM_LOGISTICS_TRANSPORT, FIRST_FLIGHT_COURIERS, FIRST_LOGISTICS, FLYT_EXPRESS, GATI_KWE, GDEX, GENIKI_TAXYDROMIKI, GIAO_HANG_NHANH, GLOBEGISTICS_INC, GLS, GLS_CZECH_REPUBLIC, GLS_ITALY, GLS_NETHERLANDS, GOFLY, GOJAVAS, GREYHOUND, GSI_EXPRESS, HERMES_GERMANY, HERMES_ITALY, HOLISOL, HOMEDIRECT_LOGISTICS, HONG_KONG_POST, HRVATSKA_POSTA, HUA_HAN_LOGISTICS, HUNTER_EXPRESS, ICELAND_POST, IDEX, IMEX_GLOBAL_SOLUTIONS, INDIA_POST_DOMESTIC, INDIA_POST_INTERNATIONAL, INPOST_PACZKOMATY, INSTANT_TIONG_NAM_EBIZ_EXPRESS_SDN_BHD, INTERNATIONAL_SEUR, INTERNET_EXPRESS, ISRAEL_POST, ISRAEL_POST_DOMESTIC, ITALY_SDA, I_PARCEL, J_T_EXPRESS, JAM_EXPRESS, JANCO_ECOMMERCE, JAPAN_POST, JAYON_EXPRESS_JEX, JCEX, JET_SHIP_WORLDWIDE, JINSUNG_TRADING, JNE, JOCOM, JP_BH_POSTA, JX, J_NET, K1_EXPRESS, KANGAROO_WORLDWIDE_EXPRESS, KERRY_EXPRESS_HONG_KONG, KERRY_EXPRESS_THAILAND, KERRY_EXPRESS_VIETNAM_CO_LTD, KGM_HUB, KIALA, KOREA_POST, KOREA_POST_EMS, KRONOS_EXPRESS, KUEHNE_NAGEL, LANDMARK_GLOBAL, LAO_POST, LASERSHIP, LBC_EXPRESS, LHT_EXPRESS, LIETUVOS_PASTAS, LINE_CLEAR_EXPRESS_LOGISTICS_SDN_BHD, LINK_BRIDGE_BEIJING_INTERNATIONAL_LOGISTICS_COLTD, LION_PARCEL, LOGISTIC_WORLDWIDE_EXPRESS, LOGWIN_LOGISTICS, LONE_STAR_OVERNIGHT, MAGYAR_POSTA, MAILAMERICAS, MAILPLUS, MAINFREIGHT, MALAYSIA_POST_EMS_POS_LAJU, MALAYSIA_POST_REGISTERED, MARA_XPRESS, MATDESPATCH, MATKAHUOLTO, MDS_COLLIVERY_PTY_LTD, MEGASAVE, MEXICO_AEROFLASH, MEXICO_REDPACK, MEXICO_SENDA_EXPRESS, MIKROPAKKET, MRW, MUDITA, MXE_EXPRESS, MYPOSTONLINE, M_XPRESS_SDN_BHD, NACEX_SPAIN, NANJING_WOYUAN, NATIONWIDE_EXPRESS, NEWGISTICS, NEWGISTICS_API, NEXIVE_TNT_POST_ITALY, NHANS_SOLUTIONS, NIGHTLINE, NIM_EXPRESS, NINJA_VAN, NINJA_VAN_INDONESIA, NINJA_VAN_MALAYSIA, NINJA_VAN_PHILIPPINES, NINJA_VAN_THAILAND, NIPOST, NOVA_POSHTA, NOVA_POSHTA_INTERNATIONAL, OCA_ARGENTINA, OLD_DOMINION_FREIGHT_LINE, OMNIVA, OMNI_PARCEL, ONE_WORLD_EXPRESS, PACKLINK, PAL_EXPRESS_LIMITED, PANDU_LOGISTICS, PAQUETEXPRESS, PARCELLEDIN, PARCELPOINT_PTY_LTD, PARCEL_POST_SINGAPORE, PAYPAL_PACKAGE, PFC_EXPRESS, PICKUPP, PICK_UPP_MYS_SGP, PILOT_FREIGHT_SERVICES, PITNEY_BOWES, PIXSELL_LOGISTICS, POCZTA_POLSKA, PORTUGAL_CTT, PORTUGAL_SEUR, POST56, POSTEN_NORGE_BRING, POSTE_ITALIANE, POSTE_ITALIANE_PACCOCELERE, POSTI, POSTNL_DOMESTIC, POSTNL_INTERNATIONAL, POSTNL_INTERNATIONAL_3S, POSTNORD_DENMARK, POSTNORD_LOGISTICS, POSTNORD_SWEDEN, POST_OF_SLOVENIA, POST_SERBIA, POS_INDONESIA_DOMESTIC, POS_INDONESIA_INTL, POSTA_ROMANA, PROFESSIONAL_COURIERS, PTT_POSTA, QUALITYPOST, QUANTIUM, QXPRESS, RABEN_GROUP, RAF_PHILIPPINES, RAIDEREX, RAM, REDUR_SPAIN, RED_CARPET_LOGISTICS, RINCOS, RL_CARRIERS, ROADBULL_LOGISTICS, ROCKET_PARCEL_INTERNATIONAL, RPX_INDONESIA, RPX_ONLINE, RRD_INTERNATIONAL_LOGISTICS_USA, RUSSIAN_POST, RUSTON, RZY_EXPRESS, SAFEXPRESS, SAGAWA, SAIA_LTL_FREIGHT, SAILPOST, SAP_EXPRESS, SAUDI_POST, SCUDEX_EXPRESS, SEINO, SEKO_LOGISTICS, SENDING_TRANSPORTE_URGENTE_Y_COMUNICACION_SAU, SENDIT, SENDLE, SFC_SERVICE, SF_EXPRESS, SF_INTERNATIONAL, SGT_CORRIERE_ESPRESSO, SHANGHAI_WISE_SUPPLY_CHAIN_MANAGEMENT_CO_LTD, SHENZHEN_JINGHUADA_LOGISTICS_CO_LTD, SHIPPIT, SHIPTOR, SHOPFANSRU_LLC, SHREE_MARUTI_COURIER_SERVICES_PVT_LTD, SHREE_TIRUPATI_COURIER_SERVICES_PVT_LTD, SHUNYOU_POST, SIMPLYPOST, SINGAPORE_POST, SINGAPORE_SPEEDPOST, SIODEMKA, SKYBOX, SKYNET_MALAYSIA, SKYNET_WORLDWIDE_EXPRESS, SKYNET_WORLDWIDE_EXPRESS_UAE, SKYNET_WORLD_WIDE_EXPRESS_SOUTH_AFRICA, SKYPOSTAL, SMOOTH_COURIERS, SMSA_EXPRESS, SOUTH_AFRICAN_POST_OFFICE, SPANISH_SEUR, SPECIALISED_FREIGHT, SPEEDEX_COURIER, SPEED_COURIERS, SPOTON_LOGISTICS_PVT_LTD, SRE_KOREA, STARTRACK, STAR_TRACK_COURIER, STAR_TRACK_EXPRESS, STO_EXPRESS, SWISHIP, SWISS_POST, TAIWAN_POST, TAQBIN_HONG_KONG, TAQBIN_MALAYSIA, TAQBIN_SINGAPORE, TCS, THAILAND_THAI_POST, THE_COURIER_GUY, TIKI, TIPSA, TNT_AUSTRALIA, TNT_CLICK_ITALY, TNT_ITALY, TNT_REFERENCE, TOLL_IPEC, TOLL_PRIORITY, TOLOS, TOPYOU, TRAKPAK, TRANSMISSION, TRANS_KARGO_INTERNASIONAL, UBI_SMART_PARCEL, UKRPOSHTA, UNITED_DELIVERY_SERVICE_LTD, UPS_FREIGHT, UPS_MAIL_INNOVATIONS, VEHO, VIETNAM_POST, VIETNAM_POST_EMS, VIETTELPOST, WAHANA, WANBEXPRESS, WEDO_LOGISTICS, WEPOST_LOGISTICS, WISELOADS, WISE_EXPRESS, WISHPOST, XEND_EXPRESS, XL_EXPRESS, XPOSTPH, XPRESSBEES, XQ_EXPRESS, YAKIT, YAMATO_JAPAN, YANWEN, YRC, YTO_EXPRESS, YUNDA_EXPRESS, YUN_EXPRESS, ZEPTOEXPRESS, ZINC, ZJS_INTERNATIONAL, ZTO_EXPRESS, ZYLLEM, CJ_PACKET}
`shipping_calculation_logic_version` float
`shipping_label_rate_type` string
`shipping_service_type` string
`shipping_package_weight` JSON object
`big_weight` JSON object	Required
`value` float	Required
`unit` enum {OUNCE, POUND, GRAM, KILOGRAM}	Required
`small_weight` JSON object	Required
`value` float	Required
`unit` enum {OUNCE, POUND, GRAM, KILOGRAM}	Required
`shipping_package_dimensions` JSON object
`unit` enum {INCH, CENTIMETER}	Required
`length` float	Required
`width` float	Required
`height` float	Required
`shipping_cost_range_lower_cost` JSON object
`currency` string	Default value: `USD`
`price` float	Required
`shipping_cost_range_upper_cost` JSON object
`currency` string	Default value: `USD`
`price` float	Required
`shipping_option_type` enum {PREPAID_LABEL, OWN_LABEL, LOCAL_DELIVERY}
`commerce_shipping_delivery_type` enum {SHIPPING, LOCAL_DELIVERY, LOCKER}
`nearby_locations` list
`name` string
`street_address` string
`latitude` float
`longitude` float
`image_url` string
`location_type` string
`location_page_id` numeric string or integer
`auto_price_drop_new_price` list
`date` string
`price` string
`xpost_surface` enum {MARKETPLACE_CROSS_POST_SUGGESTIONS, INVENTORY_MANAGEMENT, GROUP_COMPOSER, MARKETPLACE_COMPOSER, PROFILE_SELLING_CROSS_POST_SUGGESTIONS, BIZ_ON_MP_SETUP_VIEW, BSG_ATTACHMENT_TO_XPOST_TO_MP, MARKETPLACE_ASSISTANT_BOT, UNKNOWN}
`source_type` string	Default value:
`surface` string	Default value:
`source_post_id_during_creation` string
`xpost_target_ids` list
`product_hashtag_names` list
`suggested_hashtag_names` list
`product_image_ids` list
`created_through_nlu_conversion` boolean
`auction_duration` int64
`auction_minimum_bid_increment` int64
`video_ids` list
`video_types` list
`three_d_models_data` list
`asset_file_handle` string	Required
`preview_image_file_handle` string	Required
`three_d_model_ids` list
`shipping_label_rate_code` string
`shipping_label_price` string
`product_group_id` numeric string or integer
`listing_type` enum {SINGLE_ITEM, MULTI_VARIANT}
`live_shopping_video_id` numeric string or integer
`is_live_shopping_dummy_listing` boolean
`min_acceptable_checkout_offer_price` float
`comparable_price` float
`comparable_price_type` string
`category_model_source` enum {B2C, C2C, THIRDPARTY_INGESTION, SELLER_SELECTED, AICOMMERCE, JOBS, NSR, INTEGRITY, OOPS, BLENDED_MODEL, RELATED_PRODUCTS}
`xpost_profile_audience` JSON object
`base_state` enum {EVERYONE, FRIENDS, FRIENDS_OF_FRIENDS, SELF}	Required
`allow` list
`deny` list
`tag_expansion_state` enum {TAGGEES, UNSPECIFIED}
`hidden_from_friends_visibility` enum {HIDDEN_FROM_FRIENDS, VISIBLE_TO_EVERYONE}
`indexed_listing_set_id` numeric string or integer
`indexed_listing_set_data` JSON object
`availability_set` list	Required
`condition_set` list
`description_set` string
`title_set` string	Required
`should_create_indexed_listing_set` boolean
`shipping_cost_option` string
`canonical_product_item_id` numeric string or integer
`canonical_product_item_data` JSON object
`catalog_item_clustering_usecase_id` string	Default value:
`enable_reservation` boolean
`should_update_indexed_listing_set` boolean
`enable_local_explicitly` boolean
`max_additional_items` int64
`cost_per_additional_item` string
`product_item_comments_allowed` boolean
`product_item_comments_disabled` boolean
`composer_type` enum {BATCH_API, BULK_COMPOSER, MINIMAL_COMPOSER, MULTI_ITEM_COMPOSER, QUICK_COMPOSER, REAL_ESTATE_COMPOSER, REGULAR_COMPOSER, SKINNY_COMPOSER, VEHICLES_COMPOSER, VIDEO_FIRST_COMPOSER}
`sell_by_date` int64
`sku` string
`commerce_shipping_carrier` enum {AUSTRALIA_POST, CANADA_POST, CDL_LASTMILE, DELIVER_IT, DHL, DHL_ECOMMERCE_US, EAGLE, FEDEX, FEDEX_UK, NEW_ZEALAND_POST, ONTRAC, POST_DANMARK, PUROLATOR, ROYAL_MAIL, SPEE_DEE, TFORCE_FINALMILE, TNT, TNT_POST, UPS, USPS, DOORDASH, DOORDASH_ARCHIVED, DPD_FRANCE, LA_POSTE, COLISSIMO, CHRONOPOST_FRANCE, TNT_FRANCE, COLIS_PRIVE, GEODIS_DISTRIBUTION_EXPRESS, BERT_TRANSPORT, GEODIS_E_SPACE, MONDIAL_RELAY, TELIWAY_SIC_EXPRESS, AMAZON, APC_OVERNIGHT, ARROW_XL, ASENDIA_UK, BIRDSYSTEM, BLUECARE_EXPRESS_LTD, COLLECT_PLUS, DELTEC_COURIER, DPD_LOCAL, DPD_LOCAL_REFERENCE, DPD_UK, HERMESWORLD, IMX_MAIL, JERSEY_POST, MYHERMES_UK, NATIONAL_SAMEDAY, NORSK_GLOBAL, PANTHER, PANDION, PANTHER_ORDER_NUMBER, PANTHER_REFERENCE, PARCEL_FORCE, RPD2MAN_DELIVERIES, TNT_UK, TNT_UK_REFERENCE, TUFFNELLS_PARCELS_EXPRESS, UK_MAIL, WHISTL, WNDIRECT, XDP_EXPRESS, XDP_EXPRESS_REFERENCE, YODEL_DOMESTIC, YODEL_INTERNATIONAL, AMAZON_LOGISTICS, AO_LOGISTICS, APC_OVERNIGHT_CONSIGNMENT_NUMBER, AQUILINE, BANDH_WORLDWIDE, CAE_DELIVERS, DHL_PARCEL_UK, DMSMATRIX, EU_FLEET_SOLUTIONS, GBA_SERVICES_LTD, GEMWORLDWIDE, KNAIRLINK_AEROSPACE_DOMESTIC_NETWORK, OCS_WORLDWIDE, PARCEL2GO, SKYNET_WORLDWIDE_EXPRESS_UK, TUFFNELLS_PARCELS_EXPRESS_REFERENCE, XPERT_DELIVERY, MAINWAY, INTERPARCEL_UK, UNIUNI, SDH, OTHER, ABF_FREIGHT, ABX_EXPRESS, AB_CUSTOM_GROUP, ACOMMERCE, ACS_COURIER, ACS_WORLDWIDE_EXPRESS, ADICIONAL_LOGISTICS, ADSONE, AIR21, AIRPAK_EXPRESS, AIRSPEED_INTERNATIONAL_CORPORATION, ALFATREX, ALLIED_EXPRESS, ALLJOY_SUPPLY_CHAIN_CO_LTD, ALPHAFAST, AMAZON_FBA_USA, AN_POST, APC_OVERNIGHT_REFERENCE, APC_POSTAL_LOGISTICS, APRISA_EXPRESS, ARAMEX, ASENDIA_GERMANY, ASENDIA_HK, ASENDIA_HK_PREMIUM_SERVICE_LATAM, ASENDIA_USA, ASM, AUPOST_CHINA, AUSTRALIA_POST_SFTP, AUSTRIAN_POST_EXPRESS, AUSTRIAN_POST_REGISTERED, AUPOST, DHLAU, AXLEHIRE, AXL_EXPRESS_LOGISTICS, A_DUIE_PYLE, A_J_EXPRESS, B2C_EUROPE, BELPOST, BEST_EXPRESS, BEST_WAY_PARCEL, BETTER_TRUCKS, BJS_DISTRIBUTION_STORAGE_COURIERS, BJS_DISTRIBUTION_STORAGE_COURIERS_FTP, BLUEDART, BLUE_STAR, BNEED, BONDS_COURIERS, BOXC, BPOST, BPOST_INTERNATIONAL, BRAZIL_CORREIOS, BRT_BARTOLINI, BRT_BARTOLINI_PARCEL_ID, BULGARIAN_POSTS, BUYLOGIC, CAINIAO, CAMBODIA_POST, CANPAR_COURIER, CAPITAL_TRANSPORT, CARRIER_007EX, CARRIER_17_POST_SERVICE, CARRIER_2GO, CARRIER_360_LION_EXPRESS, CARRIER_4PX, CARRIER_4_72_ENTREGANDO, CARRIER_ECHO, CBL_LOGISTICS, CELERITAS_TRANSPORTE_SL, CESKA_POSTA, CHINA_EMS_EPACKET, CHINA_POST, CHIT_CHATS, CHRONOPOST_PORTUGAL, CH_ROBINSON_WORLDWIDE_INC, CITY_LINK_EXPRESS, CJ_CENTURY, CJ_CENTURY_INTERNATIONAL, CJ_GLS, CJ_KOREA_EXPRESS, CJ_LOGISTICS_INTERNATIONAL, CJ_TRANSNATIONAL_PHILIPPINES, CLEVY_LINKS, CLOUDWISH_ASIA, CNE_EXPRESS, COLLECTCO, CON_WAY_FREIGHT, COPA_AIRLINES_COURIER, CORREOS_CHILE, CORREOS_DE_COSTA_RICA, CORREOS_DE_ESPANA, CORREOS_DE_MEXICO, CORREOS_EXPRESS, CORREO_ARGENTINO, COSMETICS_NOW, COUREX, COURIERPOST, COURIERS_PLEASE, COURIER_IT, COURIER_PLUS, CPACKET, CUCKOO_EXPRESS, CYPRUS_POST, DACHSER, DAWN_WING, DAYLIGHT_TRANSPORT_LLC, DB_SCHENKER, DB_SCHENKER_SWEDEN, DD_EXPRESS_COURIER, DELCART, DELHIVERY, DELIVERYONTIME_LOGISTICS_PVT_LTD, DEMANDSHIP, DETRACK, DEUTSCHE_POST_DHL, DEUTSCHE_POST_MAIL, DEX_I, DHL_2_MANN_HANDLING, DHL_ACTIVE_TRACING, DHL_BENELUX, DHL_ECOMMERCE_ASIA, DHL_EXPRESS_PIECE_ID, DHL_GLOBAL_FORWARDING, DHL_HONG_KONG, DHL_NETHERLANDS, DHL_PARCEL_NL, DHL_PARCEL_SPAIN, DHL_POLAND_DOMESTIC, DHL_SPAIN_DOMESTIC, DIMERCO_EXPRESS_GROUP, DIRECTLOG, DIRECT_FREIGHT_EXPRESS, DIRECT_LINK, DMM_NETWORK, DOORA_LOGISTICS, DOTZOT, DPD, DPD_GERMANY, DPD_HK, DPD_IRELAND, DPD_POLAND, DPD_ROMANIA, DPD_RUSSIA, DPEX, DPEX_CHINA, DPE_EXPRESS, DPE_SOUTH_AFRICA, DSV, DTDC_AUSTRALIA, DTDC_EXPRESS_GLOBAL_PTE_LTD, DTDC_INDIA, DX, DX_FREIGHT, DYNALOGIC_BENELUX_BV, DYNAMIC_LOGISTICS, EASY_MAIL, ECARGO, ECMS_INTERNATIONAL_LOGISTICS_CO_LTD, ECOM_EXPRESS, EC_FIRSTCLASS, EFS_E_COMMERCE_FULFILLMENT_SERVICE, EKART, ELTA_HELLENIC_POST, EMIRATES_POST, EMPS_EXPRESS, ENSENDA, ENVIALIA, EPARCEL_KOREA, EP_BOX, EQUICK_CHINA, ESTAFETA, ESTES, ETOTAL_SOLUTION_LIMITED, EURODIS, EXPEDITORS, EZSHIP, FASTRAK_SERVICES, FASTWAY_AUSTRALIA, FASTWAY_IRELAND, FASTWAY_NEW_ZEALAND, FASTWAY_SOUTH_AFRICA, FEDEX_CROSS_BORDER, FEDEX_FREIGHT, FEDEX_POLAND_DOMESTIC, FERCAM_LOGISTICS_TRANSPORT, FIRST_FLIGHT_COURIERS, FIRST_LOGISTICS, FLYT_EXPRESS, GATI_KWE, GDEX, GENIKI_TAXYDROMIKI, GIAO_HANG_NHANH, GLOBEGISTICS_INC, GLS, GLS_CZECH_REPUBLIC, GLS_ITALY, GLS_NETHERLANDS, GOFLY, GOJAVAS, GREYHOUND, GSI_EXPRESS, HERMES_GERMANY, HERMES_ITALY, HOLISOL, HOMEDIRECT_LOGISTICS, HONG_KONG_POST, HRVATSKA_POSTA, HUA_HAN_LOGISTICS, HUNTER_EXPRESS, ICELAND_POST, IDEX, IMEX_GLOBAL_SOLUTIONS, INDIA_POST_DOMESTIC, INDIA_POST_INTERNATIONAL, INPOST_PACZKOMATY, INSTANT_TIONG_NAM_EBIZ_EXPRESS_SDN_BHD, INTERNATIONAL_SEUR, INTERNET_EXPRESS, ISRAEL_POST, ISRAEL_POST_DOMESTIC, ITALY_SDA, I_PARCEL, J_T_EXPRESS, JAM_EXPRESS, JANCO_ECOMMERCE, JAPAN_POST, JAYON_EXPRESS_JEX, JCEX, JET_SHIP_WORLDWIDE, JINSUNG_TRADING, JNE, JOCOM, JP_BH_POSTA, JX, J_NET, K1_EXPRESS, KANGAROO_WORLDWIDE_EXPRESS, KERRY_EXPRESS_HONG_KONG, KERRY_EXPRESS_THAILAND, KERRY_EXPRESS_VIETNAM_CO_LTD, KGM_HUB, KIALA, KOREA_POST, KOREA_POST_EMS, KRONOS_EXPRESS, KUEHNE_NAGEL, LANDMARK_GLOBAL, LAO_POST, LASERSHIP, LBC_EXPRESS, LHT_EXPRESS, LIETUVOS_PASTAS, LINE_CLEAR_EXPRESS_LOGISTICS_SDN_BHD, LINK_BRIDGE_BEIJING_INTERNATIONAL_LOGISTICS_COLTD, LION_PARCEL, LOGISTIC_WORLDWIDE_EXPRESS, LOGWIN_LOGISTICS, LONE_STAR_OVERNIGHT, MAGYAR_POSTA, MAILAMERICAS, MAILPLUS, MAINFREIGHT, MALAYSIA_POST_EMS_POS_LAJU, MALAYSIA_POST_REGISTERED, MARA_XPRESS, MATDESPATCH, MATKAHUOLTO, MDS_COLLIVERY_PTY_LTD, MEGASAVE, MEXICO_AEROFLASH, MEXICO_REDPACK, MEXICO_SENDA_EXPRESS, MIKROPAKKET, MRW, MUDITA, MXE_EXPRESS, MYPOSTONLINE, M_XPRESS_SDN_BHD, NACEX_SPAIN, NANJING_WOYUAN, NATIONWIDE_EXPRESS, NEWGISTICS, NEWGISTICS_API, NEXIVE_TNT_POST_ITALY, NHANS_SOLUTIONS, NIGHTLINE, NIM_EXPRESS, NINJA_VAN, NINJA_VAN_INDONESIA, NINJA_VAN_MALAYSIA, NINJA_VAN_PHILIPPINES, NINJA_VAN_THAILAND, NIPOST, NOVA_POSHTA, NOVA_POSHTA_INTERNATIONAL, OCA_ARGENTINA, OLD_DOMINION_FREIGHT_LINE, OMNIVA, OMNI_PARCEL, ONE_WORLD_EXPRESS, PACKLINK, PAL_EXPRESS_LIMITED, PANDU_LOGISTICS, PAQUETEXPRESS, PARCELLEDIN, PARCELPOINT_PTY_LTD, PARCEL_POST_SINGAPORE, PAYPAL_PACKAGE, PFC_EXPRESS, PICKUPP, PICK_UPP_MYS_SGP, PILOT_FREIGHT_SERVICES, PITNEY_BOWES, PIXSELL_LOGISTICS, POCZTA_POLSKA, PORTUGAL_CTT, PORTUGAL_SEUR, POST56, POSTEN_NORGE_BRING, POSTE_ITALIANE, POSTE_ITALIANE_PACCOCELERE, POSTI, POSTNL_DOMESTIC, POSTNL_INTERNATIONAL, POSTNL_INTERNATIONAL_3S, POSTNORD_DENMARK, POSTNORD_LOGISTICS, POSTNORD_SWEDEN, POST_OF_SLOVENIA, POST_SERBIA, POS_INDONESIA_DOMESTIC, POS_INDONESIA_INTL, POSTA_ROMANA, PROFESSIONAL_COURIERS, PTT_POSTA, QUALITYPOST, QUANTIUM, QXPRESS, RABEN_GROUP, RAF_PHILIPPINES, RAIDEREX, RAM, REDUR_SPAIN, RED_CARPET_LOGISTICS, RINCOS, RL_CARRIERS, ROADBULL_LOGISTICS, ROCKET_PARCEL_INTERNATIONAL, RPX_INDONESIA, RPX_ONLINE, RRD_INTERNATIONAL_LOGISTICS_USA, RUSSIAN_POST, RUSTON, RZY_EXPRESS, SAFEXPRESS, SAGAWA, SAIA_LTL_FREIGHT, SAILPOST, SAP_EXPRESS, SAUDI_POST, SCUDEX_EXPRESS, SEINO, SEKO_LOGISTICS, SENDING_TRANSPORTE_URGENTE_Y_COMUNICACION_SAU, SENDIT, SENDLE, SFC_SERVICE, SF_EXPRESS, SF_INTERNATIONAL, SGT_CORRIERE_ESPRESSO, SHANGHAI_WISE_SUPPLY_CHAIN_MANAGEMENT_CO_LTD, SHENZHEN_JINGHUADA_LOGISTICS_CO_LTD, SHIPPIT, SHIPTOR, SHOPFANSRU_LLC, SHREE_MARUTI_COURIER_SERVICES_PVT_LTD, SHREE_TIRUPATI_COURIER_SERVICES_PVT_LTD, SHUNYOU_POST, SIMPLYPOST, SINGAPORE_POST, SINGAPORE_SPEEDPOST, SIODEMKA, SKYBOX, SKYNET_MALAYSIA, SKYNET_WORLDWIDE_EXPRESS, SKYNET_WORLDWIDE_EXPRESS_UAE, SKYNET_WORLD_WIDE_EXPRESS_SOUTH_AFRICA, SKYPOSTAL, SMOOTH_COURIERS, SMSA_EXPRESS, SOUTH_AFRICAN_POST_OFFICE, SPANISH_SEUR, SPECIALISED_FREIGHT, SPEEDEX_COURIER, SPEED_COURIERS, SPOTON_LOGISTICS_PVT_LTD, SRE_KOREA, STARTRACK, STAR_TRACK_COURIER, STAR_TRACK_EXPRESS, STO_EXPRESS, SWISHIP, SWISS_POST, TAIWAN_POST, TAQBIN_HONG_KONG, TAQBIN_MALAYSIA, TAQBIN_SINGAPORE, TCS, THAILAND_THAI_POST, THE_COURIER_GUY, TIKI, TIPSA, TNT_AUSTRALIA, TNT_CLICK_ITALY, TNT_ITALY, TNT_REFERENCE, TOLL_IPEC, TOLL_PRIORITY, TOLOS, TOPYOU, TRAKPAK, TRANSMISSION, TRANS_KARGO_INTERNASIONAL, UBI_SMART_PARCEL, UKRPOSHTA, UNITED_DELIVERY_SERVICE_LTD, UPS_FREIGHT, UPS_MAIL_INNOVATIONS, VEHO, VIETNAM_POST, VIETNAM_POST_EMS, VIETTELPOST, WAHANA, WANBEXPRESS, WEDO_LOGISTICS, WEPOST_LOGISTICS, WISELOADS, WISE_EXPRESS, WISHPOST, XEND_EXPRESS, XL_EXPRESS, XPOSTPH, XPRESSBEES, XQ_EXPRESS, YAKIT, YAMATO_JAPAN, YANWEN, YRC, YTO_EXPRESS, YUNDA_EXPRESS, YUN_EXPRESS, ZEPTOEXPRESS, ZINC, ZJS_INTERNATIONAL, ZTO_EXPRESS, ZYLLEM, CJ_PACKET}
`shipping_calculation_logic_version` float
`shipping_label_rate_type` string
`shipping_service_type` string
`shipping_package_weight` JSON object
`big_weight` JSON object	Required
`value` float	Required
`unit` enum {OUNCE, POUND, GRAM, KILOGRAM}	Required
`small_weight` JSON object	Required
`value` float	Required
`unit` enum {OUNCE, POUND, GRAM, KILOGRAM}	Required
`shipping_package_dimensions` JSON object
`unit` enum {INCH, CENTIMETER}	Required
`length` float	Required
`width` float	Required
`height` float	Required
`shipping_cost_range_lower_cost` string
`shipping_cost_range_upper_cost` string
`personalization_info` string
`is_personalization_required` boolean
`relisted_from_listing_id` numeric string or integer
`commerce_shipping_carriers` list
`include_listing_info_in_rating` enum {ENABLE_INCLUDE_LISTING_INFO_IN_RATING, DISABLE_INCLUDE_LISTING_INFO_IN_RATING}
`has_multiple_items` boolean
`public_meetup_location_page_ids` list
`is_meetup_location_public` boolean
`listing_email_id` numeric string or integer
`is_photo_order_set_by_seller` boolean
`brand_page_id` string
`is_giveaway` boolean
`payment_preferences` list
`scheduled_publish_time` int64	SELF_EXPLANATORY
`should_sync_product_edit` boolean	should_sync_product_edit
`source_type` string	source_type
`sponsor_id` numeric string or integer	Facebook Page id that is tagged as sponsor in the Feed post
`sponsor_relationship` int64	Sponsor Relationship, such as Presented By or Paid PartnershipWith
`tags` list	SELF_EXPLANATORY
`text_format_preset_id` numeric string or integer	text_format_preset_id
`timeline_visibility` enum{hidden, normal, forced_allow}	SELF_EXPLANATORY
`tracking` JSON-encoded string	SELF_EXPLANATORY

Return Type

This endpoint supports read-after-write and will read the node to which you POSTed.

Struct {

success: bool,

}

Error Codes

Error	Description
210	User not visible
100	Invalid parameter
368	The action attempted has been deemed abusive or is otherwise disallowed
200	Permissions error
102	Session key invalid or no longer valid
190	Invalid OAuth 2.0 Access Token
104	Incorrect signature

Deleting

Only select developers can perform this operation using the API. You can use the Business Manager to delete posts.

You can delete a PagePost by making a DELETE request to /{page_post_id}.

Example

Graph API Explorer

DELETE /v23.0/{page-id}_{post-id}/ HTTP/1.1
Host: graph.facebook.com

/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->delete(
    '/{page-id}_{post-id}/',
    array (),
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */

/* make the API call */
FB.api(
    "/{page-id}_{post-id}/",
    "DELETE",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{page-id}_{post-id}/",
    null,
    HttpMethod.DELETE,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();

/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{page-id}_{post-id}/"
                                      parameters:params
                                      HTTPMethod:@"DELETE"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

curl -X DELETE -G \
  -F 'access_token=' \
  https://graph.facebook.com/v23.0/{page-id}_{post-id}/

If you want to learn how to use the Graph API, read our Using Graph API guide.

Parameters

This endpoint doesn't have any parameters.

Return Type

Struct {

success: bool,

}

Error Codes

Error	Description
200	Permissions error
100	Invalid parameter
190	Invalid OAuth 2.0 Access Token
368	The action attempted has been deemed abusive or is otherwise disallowed
80001	There have been too many calls to this Page account. Wait a bit and try again. For more info, please refer to https://developers.facebook.com/docs/graph-api/overview/rate-limiting.