Skip to main content
POST
Request native video access and send creator guides for the selected source indices

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:write
Create and manage ad campaigns and connected ad accounts (sensitive — this can spend money)

Headers

Idempotency-Key
string

Client-chosen key; replaying the same key + body returns the original response, a different body returns 409.

Body

application/json
connectionId
string
required
Minimum string length: 1
sources
object[]
required
Required array length: 1 - 50 elements
sourceIndices
integer[]
required
Required array length: 1 - 50 elements
Required range: x >= 0

Response

Success. Returns the resource envelope.

The response is of type object.