Skip to main content
POST
Add a social account to a contract

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.

Headers

Idempotency-Key
string

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

Path Parameters

id
string
required

The contract id.

Body

application/json

The social account to add to the contract.

platform
enum<string>
required

Social platform of the account. x is stored as twitter.

Available options:
tiktok,
instagram,
youtube,
snapchat,
facebook,
twitter,
linkedin,
x
handle
string
required

The account handle, with or without @. A profile URL is also accepted.

Required string length: 1 - 200

Response

The account is on the contract.

data
object
required