Skip to main content

Connect Walmart Connect

POST 

/api/advertising/walmart-connect/connections

Connects Walmart Connect (Walmart's sponsored-products platform). Walmart Connect has no OAuth sign-in: the advertiser first adds SKU.io as an API partner in Walmart Ad Center, then this call creates the connection and claims the advertiser ids it names. Walmart lists the advertisers that granted SKU.io access only through an asynchronous snapshot, so the call answers at once with discovery_status: pending and the id of the background job (discovery_tracked_job_log_id) that asks Walmart which of those advertisers granted access and creates an ad account for each (unselected; select them with Update Ad Account). List the connection's ad accounts once that job completes; each account's access_level is the access Walmart granted (full needs Campaign Manager with Edit permission, otherwise reporting_only). If none of the named advertisers has granted SKU.io access, the job fails and a new connection is removed. Re-running it for an advertiser that already has an account updates that account.

Required scope: advertising:write

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Requires the advertising.manage permission. Token scope: advertising:write (personal access and OAuth tokens).

Body:

  • name (string, required, max 255): name for the connection. A name another connection already uses is numbered, e.g. Walmart Connect (2); the response's name is the one saved.
  • advertiser_ids (array, required, 1 to 50): the Walmart advertiser ids (digits only, as shown in Walmart Ad Center) to connect. The connection only ever takes the advertisers it names, and the call fails unless every one of them is in Walmart's granted list.
  • advertiser_ids.* (string, required per entry): 1 to 20 digits.

Returns 422 (and creates nothing) when Walmart Connect is still awaiting platform approval for SKU.io, when advertiser_ids is missing or empty, when a listed advertiser is already connected to another SKU.io account (contact SKU.io support to move it), or when it is already connected on another Walmart Connect connection of this account. Whether each advertiser granted SKU.io access is checked by the background job, not by this call.

Request​

Responses​

OK

Response Headers
    Content-Type