Skip to main content

Get Ad Platform Authorization URL

GET 

/api/advertising/connections/:platform/authorization-url

Starts connecting an ad platform and returns the URL to send the user to. For OAuth platforms this is the platform's consent page; after the user approves, the platform redirects back to SKU.io, which stores the tokens and discovers the ad accounts (they arrive unselected; select them with Update Ad 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), even though this is a GET: the sign-in it starts creates or replaces a connection. A read-only token gets 403.

platform values and their query parameters:

  • amazon_ads: Login with Amazon. New connection: region (NA, EU or FE) and name are both required. Re-authorize an existing connection: pass integration_instance_id instead (its region and name are reused).
  • ebay: integration_instance_id is required and must be one of your eBay sales channels. When that channel's token already carries the marketing scope, no consent is needed: its advertiser accounts are discovered immediately and the returned url points straight back to SKU.io. Otherwise the URL is an eBay re-consent page that adds the scope.
  • google_ads: Google OAuth. Optional integration_instance_id to re-authorize an existing connection.
  • meta_ads: Facebook Login. Optional name (default Meta Ads) and integration_instance_id.
  • tiktok_ads: TikTok API for Business. Optional name (default TikTok Ads) and integration_instance_id.
  • walmart_connect: not an OAuth platform; this always returns 422. Use Connect Walmart Connect instead.

Returns 422 when the platform is unknown, has no connector, or is still awaiting platform approval for SKU.io (access_level below reporting_only), and when a platform-specific parameter fails validation.

Request​

Responses​

OK

Response Headers
    Content-Type