Product Catalog Marketplace Partner Signals
Updated: Mar 5, 2026
Reading
You can’t perform this operation on this endpoint.
Creating
You can't perform this operation on this endpoint.
Updating
/{product_catalog_id}/marketplace_partner_signals
You can update a ProductCatalog by making a POST request to /{product_catalog_id}/marketplace_partner_signals.
Parameters
| Parameter | Description |
|---|---|
conversion_typeenum {ATTRIBUTED, IN_SESSION} |
conversion_type
Identifier on whether the specified event happened within the original session of the user landing on the partner's page (IN_SESSION) or within the attribution window after the initial session (ATTRIBUTED)
|
event_idstring |
event_id
Unique identifier for conversion events. If there are multiple conversion events tied to a single mp_clid, this field will be used to differentiate between those events
|
event_nameenum {PURCHASE, ADD_TO_CART, VIEW_ITEM, OFFER_SUBMITTED, PURCHASE_VIA_OFFER, TEST} |
event_name
TEST events can be used to send test data to confirm API functionality that Marketplace will ignore
required |
event_source_urlstring |
event_source_url
|
event_timedatetime/timestamp |
event_time
required |
offer_dataJSON object |
offer_data
original_price float
original_price
required offer_price float
offer_price
required currency string
currency
required Show child parameters |
order_dataJSON object |
order_data
order_details array<JSON object>Default value: []
order_details
item_price float
item_price
required item_quantity int64
item_quantity
required item_id string
item_id
required Show child parameters currency string
currency
required order_total float
order_total
required Show child parameters |
user_dataJSON object |
user_data
required mp_clid string
mp_clid
required Show child parameters |
Return Type
This endpoint supports read-after-write and will read the node to which you POSTed.
Struct {
success: bool,
validation_status: List [ Struct {
errors: List [ Struct {
message: string,
}],
warnings: List [ Struct {
message: string,
}],
}],
}
Error Codes
| Error Code | Description |
|---|---|
100 | Invalid parameter |
Deleting
You can't perform this operation on this endpoint.