Skip to main content
POST
Draft a shallow paused Google settings copy

Authorizations

Authorization
string
header
required

OAuth 2.1 authorization code + PKCE (S256). Tokens are tenant-bound (company_id) and scoped. Discover endpoints via /.well-known/oauth-authorization-server.

FlowAuthorization Code
Authorization URL
https://app.sideshift.app/api/oauth/v1/authorize
Token URL
https://app.sideshift.app/api/oauth/v1/token
Refresh URL
https://app.sideshift.app/api/oauth/v1/token
Scopes1
ads:read
Read ad accounts, campaigns, delivery status, and performance data

Body

application/json

Read-only exact native settings source. Campaign settings require a new campaign. Ad-group settings may target a new or existing same-customer campaign. Returns a reviewable paused settings-only draft; no source ads, goal resources or campaigns are created.

connectionId
string
required
Required string length: 1 - 200
source
object
required
destination
object
required

Response

Read-only source candidates or settings-only draft. Listing a candidate does not establish support; the selected draft either contains full settings and provenance or returns a named blocker.

The response is of type object.