PUT
/
v1
/
teams
/
{teamId}
/
social-accounts
/
{id}
/
publish-defaults
TypeScript client
import { OctosparkClient } from '@octospark/sdk'

const client = new OctosparkClient({
  token: process.env.OCTOSPARK_TOKEN
})

const response = await client.social.setSocialAccountPublishDefaults({
  teamId: process.env.OCTOSPARK_TEAM_ID ?? "teamId",
  id: process.env.OCTOSPARK_ID ?? "id",
  body: {},
})
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "teamId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "providerAccountId": "<string>",
  "displayName": "<string>",
  "profileHandle": "<string>",
  "maxPostsPerDay": 123,
  "postingLimitRevision": 123,
  "publicationCapacity": {
    "utcDay": "<string>",
    "published": 123,
    "reserved": 123,
    "remaining": 123,
    "blockedByUncertainAttempt": true
  },
  "profileImageUrl": "<string>",
  "accountSubType": "<string>",
  "scopes": [
    "<string>"
  ],
  "providerSettings": {},
  "capabilities": {},
  "connectedAt": "<string>",
  "disconnectedAt": "<string>",
  "createdAt": "<string>",
  "updatedAt": "<string>",
  "accountHealthMessage": "<string>",
  "accountHealthSince": "<string>"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
teamId
string
required

Team (workspace) id (UUID). Discover ids via the list teams endpoint or the agent context.

​
id
string
required

Connected social account id (UUID), as returned by the list social accounts endpoint.

Body

application/json

Per-account remembered publish choices. Only settings for the account's provider are accepted; schedulePost and postNow use them when a call omits the setting.

​
privacyLevel
string | null

TikTok only: privacy level to remember, one of the account's creator-info privacyLevelOptions. null forgets it.

​
commercialContentDisclosure
boolean | null

TikTok only: remember whether the commercial content disclosure toggle is on. null forgets it.

​
brandOrganic
boolean | null

TikTok only: remember the Your brand disclosure. null forgets it.

​
brandedContent
boolean | null

TikTok only: remember the Branded content disclosure. null forgets it.

​
selfDeclaredMadeForKids
boolean | null

YouTube only: remember the made-for-kids audience declaration. null forgets it.

Response

Success

​
id
string<uuid>
required

a Universally Unique Identifier

Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
​
teamId
string<uuid>
required

a Universally Unique Identifier

Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
​
provider
enum<string>
required

Social platform identifier: x, tiktok, instagram, facebook, youtube, linkedin, threads, or pinterest.

Available options:
x,
tiktok,
instagram,
facebook,
youtube,
linkedin,
threads,
pinterest
Example:

"x"

​
providerAccountId
string
required
​
displayName
string
required
​
profileHandle
string | null
required
​
maxPostsPerDay
number | null
required

Maximum publications per UTC day across all campaigns and schedules. New accounts default to 3; explicitly saved limits are preserved. Null is retained for legacy compatibility.

​
postingLimitRevision
number
required
​
publicationCapacity
object
required
​
profileImageUrl
string | null
required
​
accountSubType
string | null
required
​
status
enum<string>
required

Connection state of a social account: connected (usable), disabled, refresh_needed (token expired, reconnect required), or disconnected.

Available options:
connected,
disabled,
refresh_needed,
disconnected
Example:

"connected"

​
scopes
string[]
required
​
providerSettings
object
required
​
capabilities
object
required
​
connectedAt
string
required
​
disconnectedAt
string | null
required
​
createdAt
string
required
​
updatedAt
string
required
​
accountHealthIssue
enum<string> | null
required
Available options:
verification_required,
auth_failed,
rate_limited,
token_refresh_failing
​
accountHealthMessage
string | null
required
​
accountHealthSince
string | null
required