Skip to main content
POST
Accept creator-initiated native video access for one selected source

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
sourceIndex
integer
required
Required range: x >= 0

Response

Success. Returns the resource envelope.

The response is of type object.