PUT /api/v2/buyer/storefront-connections/{connectionId}/accounts/{accountId}/enhanced-reporting
Enhanced Reporting is an account-level control. It applies only to the exact
connected account in the path; it does not change sibling accounts, seller
feature policy, connectivity, mappings, or directed campaigns. Enabling records
the account’s reporting preference and its billing boundary. The account becomes
billed only after its reporting subscription successfully completes a sync; if
no reporting subscription is configured, the request creates no IU activity.
Disabling stops future work while preserving reports and billing evidence.
Enabling requires a live connected account and an accepted plan that is in force
for the billing organization. A Listing account has no access to Enhanced
Reporting, so enabling it there is refused; change the account to a Storefront
agent first (see Change a Seller Account’s type).
Switching an account to Listing closes its Enhanced Reporting. The plan does not have to list Enhanced Reporting:
a Rate Card that does not mention it carries the published catalog default.
The SOCIAL_ACCOUNT_INTELLIGENCE_BILLING_PERIOD activity is rated once per
account per billing period at the effective price for that plan (the catalog
default is 4 IUs, unless the Rate Card or plan sets another price), after the
first successful reporting sync that follows enablement. A plan that waives
Enhanced Reporting still allows enabling, and the activity rates at zero.
Request
Response
{ "enabled": false }.
Errors
400 VALIDATION_ERROR— the account or its parent connection is inactive, the billing organization has no accepted plan in force, or the account is a Listing account (details.reasonislisting_account). A read of the account shows this aseligible: falsewithineligibleReason: "listing_account".401 UNAUTHORIZED— the bearer token is missing or invalid.404 NOT_FOUND— the account does not belong to that connection or buyer.
save_connection syntax and the Connections UI.