Skip to content
AdVentur.aiAdVentur.aiAdVentur.ai Docs

Social accounts API

Connect, list and update the social accounts a workspace publishes to.

6 endpoints. Every path is relative to the API base URL and needs a bearer token unless it is marked public. See the REST API overview for authentication, errors and pagination.

GET/v1/orgs/{orgId}/marketing/accounts

Bearer tokenMCP tool: list_social_accounts

List the workspace's connected social accounts (platform, handle, connection status). Use an account's id as socialAccountId when drafting a post for a specific account.

Path parameters

  • orgIdstring (uuid)required

Responses

200
  • dataarray<object>required
    Item fields
    • idstring (uuid)required
    • orgIdstring (uuid)required
    • platformstringrequired

      one of x, linkedin, tiktok, reddit, facebook, instagram, youtube, bluesky, threads

    • accountExternalIdstringrequired
    • accountNamestring | nullrequired
    • accountHandlestring | nullrequired
    • statusstringrequired

      one of connected, disconnected, error

    • scopesarray<string>required
    • tokenExpiresAtstring | nullrequired
    • lastRefreshedAtstring | nullrequired
    • createdAtstringrequired
    • updatedAtstringrequired
    • profileImageUrlstring (uri) | null
    • accountBiostring | null
    • profileUrlstring (uri) | null
    • xPremiumboolean | null
    • xSubscriptionstring | null

      one of none, basic, premium, premium_plus

Request
curl -X GET "https://api.adventur.ai/v1/orgs/$ORG_ID/marketing/accounts" \
  -H "Authorization: Bearer $ADVENTURAI_TOKEN"

PATCH/v1/orgs/{orgId}/marketing/accounts/{accountId}

Bearer token

Set the profile link shown for a connected account.

Path parameters

  • orgIdstring (uuid)required
  • accountIdstring (uuid)required

Request body application/json

  • profileUrlstring | nullrequired

Responses

200Set the profile link shown for a connected account.
  • dataobjectrequired
    Fields
    • idstring (uuid)required
    • orgIdstring (uuid)required
    • platformstringrequired

      one of x, linkedin, tiktok, reddit, facebook, instagram, youtube, bluesky, threads

    • accountExternalIdstringrequired
    • accountNamestring | nullrequired
    • accountHandlestring | nullrequired
    • statusstringrequired

      one of connected, disconnected, error

    • scopesarray<string>required
    • tokenExpiresAtstring | nullrequired
    • lastRefreshedAtstring | nullrequired
    • createdAtstringrequired
    • updatedAtstringrequired
    • profileImageUrlstring (uri) | null
    • accountBiostring | null
    • profileUrlstring (uri) | null
    • xPremiumboolean | null
    • xSubscriptionstring | null

      one of none, basic, premium, premium_plus

Request
curl -X PATCH "https://api.adventur.ai/v1/orgs/$ORG_ID/marketing/accounts/$ACCOUNT_ID" \
  -H "Authorization: Bearer $ADVENTURAI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"profileUrl":"string"}'

DELETE/v1/orgs/{orgId}/marketing/accounts/{accountId}

Bearer token

Path parameters

  • orgIdstring (uuid)required
  • accountIdstring (uuid)required

Responses

200
  • dataobjectrequired
    Fields
    • idstring (uuid)required
    • orgIdstring (uuid)required
    • platformstringrequired

      one of x, linkedin, tiktok, reddit, facebook, instagram, youtube, bluesky, threads

    • accountExternalIdstringrequired
    • accountNamestring | nullrequired
    • accountHandlestring | nullrequired
    • statusstringrequired

      one of connected, disconnected, error

    • scopesarray<string>required
    • tokenExpiresAtstring | nullrequired
    • lastRefreshedAtstring | nullrequired
    • createdAtstringrequired
    • updatedAtstringrequired
    • profileImageUrlstring (uri) | null
    • accountBiostring | null
    • profileUrlstring (uri) | null
    • xPremiumboolean | null
    • xSubscriptionstring | null

      one of none, basic, premium, premium_plus

Request
curl -X DELETE "https://api.adventur.ai/v1/orgs/$ORG_ID/marketing/accounts/$ACCOUNT_ID" \
  -H "Authorization: Bearer $ADVENTURAI_TOKEN"

GET/v1/orgs/{orgId}/marketing/accounts/{accountId}/tiktok/creator-info

Bearer token

Fetch the connected TikTok creator's current privacy/interaction options for the composer.

Path parameters

  • orgIdstring (uuid)required
  • accountIdstring (uuid)required

Responses

200Fetch the connected TikTok creator's current privacy/interaction options for the composer.
  • dataobjectrequired
    Fields
    • creatorAvatarUrlstring (uri) | nullrequired
    • creatorUsernamestring | nullrequired
    • creatorNicknamestring | nullrequired
    • privacyLevelOptionsarray<string>required
    • commentDisabledbooleanrequired
    • duetDisabledbooleanrequired
    • stitchDisabledbooleanrequired
    • maxVideoPostDurationSecnumber | nullrequired
    • directPostEnabledbooleanrequired
Request
curl -X GET "https://api.adventur.ai/v1/orgs/$ORG_ID/marketing/accounts/$ACCOUNT_ID/tiktok/creator-info" \
  -H "Authorization: Bearer $ADVENTURAI_TOKEN"

POST/v1/orgs/{orgId}/marketing/accounts/{platform}/oauth/start

Bearer token

Path parameters

  • orgIdstring (uuid)required
  • platformstringrequired

    one of x, linkedin, tiktok, reddit, facebook, instagram, youtube, bluesky, threads

Request body application/json

  • redirectUristring (uri)required
  • linkedinTargetstring

    one of profile, page

  • blueskyHandlestring

Responses

200
  • dataobjectrequired
    Fields
    • authorizationUrlstring (uri)required
    • statestringrequired
Request
curl -X POST "https://api.adventur.ai/v1/orgs/$ORG_ID/marketing/accounts/$PLATFORM/oauth/start" \
  -H "Authorization: Bearer $ADVENTURAI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"redirectUri":"https://example.com"}'

POST/v1/orgs/{orgId}/marketing/accounts/bluesky/connect

Bearer token

Connect a Bluesky account with its handle and an app password.

Path parameters

  • orgIdstring (uuid)required

Request body application/json

  • handlestringrequired
  • appPasswordstringrequired

Responses

200Connect a Bluesky account with its handle and an app password.
  • dataobjectrequired
    Fields
    • idstring (uuid)required
    • orgIdstring (uuid)required
    • platformstringrequired

      one of x, linkedin, tiktok, reddit, facebook, instagram, youtube, bluesky, threads

    • accountExternalIdstringrequired
    • accountNamestring | nullrequired
    • accountHandlestring | nullrequired
    • statusstringrequired

      one of connected, disconnected, error

    • scopesarray<string>required
    • tokenExpiresAtstring | nullrequired
    • lastRefreshedAtstring | nullrequired
    • createdAtstringrequired
    • updatedAtstringrequired
    • profileImageUrlstring (uri) | null
    • accountBiostring | null
    • profileUrlstring (uri) | null
    • xPremiumboolean | null
    • xSubscriptionstring | null

      one of none, basic, premium, premium_plus

Request
curl -X POST "https://api.adventur.ai/v1/orgs/$ORG_ID/marketing/accounts/bluesky/connect" \
  -H "Authorization: Bearer $ADVENTURAI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"handle":"string","appPassword":"string"}'