> ## Documentation Index
> Fetch the complete documentation index at: https://docs.woopsocial.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get platform-specific input options

> Returns platform-specific input options for a connected social account.

Use this endpoint to discover valid values for flattened post-target
fields such as `pinterestBoardId` and `privacyLevel`.




## OpenAPI

````yaml /openapi.yaml get /social-accounts/{socialAccountId}/platform-inputs
openapi: 3.1.0
info:
  title: WoopSocial API
  version: 1.0.0
  summary: API for WoopSocial integrations.
  description: >
    This is the public-facing OpenAPI contract for WoopSocial. It supports
    scheduling posts for various social media platforms such as Facebook,
    Instagram, LinkedIn, LinkedIn Pages, Pinterest, Threads, TikTok, X (formerly
    Twitter) and YouTube.
servers:
  - url: https://api.woopsocial.com/v1
    description: WoopSocial API URL.
  - url: http://localhost:9123/api/external/v1
    description: Local WoopSocial API URL.
security: []
tags:
  - name: Posts
    description: Post scheduling endpoints.
  - name: Projects
    description: Project discovery endpoints.
  - name: Social Accounts
    description: Connected social account discovery endpoints.
  - name: Media
    description: Media upload endpoints.
  - name: Webhooks
    description: Webhook endpoint management.
  - name: Health
    description: Basic connectivity endpoints.
paths:
  /social-accounts/{socialAccountId}/platform-inputs:
    get:
      tags:
        - Social Accounts
      summary: Get platform-specific input options
      description: |
        Returns platform-specific input options for a connected social account.

        Use this endpoint to discover valid values for flattened post-target
        fields such as `pinterestBoardId` and `privacyLevel`.
      operationId: getSocialAccountPlatformInputs
      parameters:
        - $ref: '#/components/parameters/SocialAccountId'
      responses:
        '200':
          description: Social account-specific platform input options.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SocialAccountPlatformInputs'
      security:
        - ApiKey: []
components:
  parameters:
    SocialAccountId:
      name: socialAccountId
      in: path
      required: true
      schema:
        type: string
      description: Connected social account identifier.
  schemas:
    SocialAccountPlatformInputs:
      type: object
      additionalProperties: false
      required:
        - socialAccountId
        - platformSpecificInputs
      properties:
        socialAccountId:
          type: string
          description: Connected social account identifier.
        platformSpecificInputs:
          $ref: '#/components/schemas/SocialAccountPlatformSpecificInputs'
    SocialAccountPlatformSpecificInputs:
      oneOf:
        - $ref: '#/components/schemas/PinterestSocialAccountPlatformSpecificInputs'
        - $ref: '#/components/schemas/TikTokSocialAccountPlatformSpecificInputs'
      discriminator:
        propertyName: platform
        mapping:
          PINTEREST:
            $ref: '#/components/schemas/PinterestSocialAccountPlatformSpecificInputs'
          TIKTOK:
            $ref: '#/components/schemas/TikTokSocialAccountPlatformSpecificInputs'
    PinterestSocialAccountPlatformSpecificInputs:
      title: Pinterest Social Account Platform Specific Inputs
      type: object
      additionalProperties: false
      required:
        - platform
        - boards
      properties:
        platform:
          allOf:
            - $ref: '#/components/schemas/SocialPlatform'
            - type: string
              enum:
                - PINTEREST
        boards:
          type: array
          description: |
            Available Pinterest boards for this account.

            Each `id` value can be sent as `pinterestBoardId` when creating a
            post for a Pinterest social account target.
          items:
            $ref: '#/components/schemas/PinterestBoardOption'
    TikTokSocialAccountPlatformSpecificInputs:
      title: TikTok Social Account Platform Specific Inputs
      type: object
      additionalProperties: false
      required:
        - platform
        - privacyLevelOptions
        - commentAvailable
        - duetAvailable
        - stitchAvailable
        - maxVideoPostDurationSec
      properties:
        platform:
          allOf:
            - $ref: '#/components/schemas/SocialPlatform'
            - type: string
              enum:
                - TIKTOK
        privacyLevelOptions:
          type: array
          description: |
            Privacy values currently allowed for this TikTok account.

            Each value can be sent as `privacyLevel` when creating a post for a
            TikTok social account target.
          items:
            $ref: '#/components/schemas/TikTokPrivacyLevel'
        commentAvailable:
          type: boolean
          description: Whether comments can currently be allowed for this TikTok account.
        duetAvailable:
          type: boolean
          description: >-
            Whether duets can currently be allowed for video posts on this
            TikTok account.
        stitchAvailable:
          type: boolean
          description: >-
            Whether stitches can currently be allowed for video posts on this
            TikTok account.
        maxVideoPostDurationSec:
          type: integer
          format: int32
          minimum: 1
          description: Maximum TikTok video duration currently allowed for this account.
    SocialPlatform:
      type: string
      enum:
        - PINTEREST
        - LINKEDIN
        - LINKEDIN_PAGES
        - INSTAGRAM
        - FACEBOOK
        - THREADS
        - TIKTOK
        - X
        - YOUTUBE
        - WOOPTEST
      description: |
        Identifies which social media platform this data structure targets.
    PinterestBoardOption:
      type: object
      additionalProperties: false
      required:
        - id
        - name
      properties:
        id:
          type: string
          description: Pinterest board identifier.
        name:
          type: string
          description: Human-readable Pinterest board name.
    TikTokPrivacyLevel:
      type: string
      enum:
        - PUBLIC_TO_EVERYONE
        - SELF_ONLY
        - MUTUAL_FOLLOW_FRIENDS
        - FOLLOWER_OF_CREATOR
  securitySchemes:
    ApiKey:
      type: http
      scheme: bearer
      bearerFormat: API key

````