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).
advertising:writeGrant 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,EUorFE) andnameare both required. Re-authorize an existing connection: passintegration_instance_idinstead (its region and name are reused).ebay:integration_instance_idis 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 returnedurlpoints straight back to SKU.io. Otherwise the URL is an eBay re-consent page that adds the scope.google_ads: Google OAuth. Optionalintegration_instance_idto re-authorize an existing connection.meta_ads: Facebook Login. Optionalname(defaultMeta Ads) andintegration_instance_id.tiktok_ads: TikTok API for Business. Optionalname(defaultTikTok Ads) andintegration_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
- 200
- 401
- 403
- 404
- 422
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden
Response Headers
Not found — no record with the given identifier (or the route does not exist). Verify the ID before retrying.
Unprocessable Entity
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.