Skip to main content
POST

Authorizations

Authorization
string
header
required

A Motion API key. Access is limited to its stored organization, workspace, scopes and the creator’s current permissions.

Scopes

motion:connectors:write

Connect and disconnect your private accounts inside the credential organization workspace.

Body

application/json
connector_id
enum<string>
required
Available options:
github,
notion,
google-drive

Response

Connection setup started.

connector_id
enum<string>
required

Service ID; the connection id identifies a saved account.

Available options:
github,
notion,
google-drive,
getty,
s3,
tiktok,
youtube,
instagram,
facebook,
x,
threads,
linkedin,
reddit,
mastodon,
bluesky,
snapchat,
figma,
dropbox,
slack,
x-account
scope
string
required

Connection belongs to the credential’s organization and workspace.

Allowed value: "organization"
visibility
string
required
Allowed value: "private"
status
string
required
Allowed value: "pending_authorization"
authorization_url
string<uri>
required

Provider authorization page for a person to approve; this response is not a connected account.

expires_at
string | null
required
connections_url
string
required

Poll this API path after approval to discover the saved connection UUID.