---
title: "Fetch integration dynamic options"
method: POST
path: "/v1/workspaces/{workspaceId}/integrations/{integrationId}/options/{optionKey}"
tags: ["Integrations"]
---

# Fetch integration dynamic options

`POST /v1/workspaces/{workspaceId}/integrations/{integrationId}/options/{optionKey}`

## Request

- Base URL: `https://api.maevesocial.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.maevesocial.com/v1/workspaces/{workspaceId}/integrations/{integrationId}/options/{optionKey}`
- Auth: HTTP bearer

Fetches safe read-only provider options such as Pinterest boards, YouTube categories, TikTok creator info, locations, catalogs, or products.

## Path parameters

- `integrationId` string, required
- `optionKey` string, required
- `workspaceId` string, uuid, required

## Request body

- PublicIntegrationOptionsBodyDto
  - `countryCode` string, nullable
  - `genre` string, nullable
  - `dateRange` '1DAY' | '7DAY' | '30DAY' | '90DAY', nullable
  - `regionCode` string, nullable
  - `query` string, nullable
  - `catalogId` string, nullable
  - `audioType` 'music' | 'original_sound', nullable

## Response `201`

Options for the requested optionKey and connected account

- object
  - `data` union, required
    - object: pinterest-boards
      - `boards` object[], required
        - `id` string, required
        - `name` string, required
        - `privacy` string, required
    - object: youtube-video-categories
      - `categories` object[], required
        - `id` string, required
        - `title` string, required
    - object: tiktok-creator-info
      - `creatorInfo` object, required
        - `privacyLevelOptions` string[], required
        - `commentDisabled` boolean, required
        - `duetDisabled` boolean, required
        - `stitchDisabled` boolean, required
        - `maxVideoPostDurationSec` number, nullable, required
        - `creatorNickname` string, nullable, required
        - `creatorUsername` string, nullable, required
        - `creatorAvatarUrl` string, nullable, required
        - `isAudited` boolean, required
        - `canDirectPost` boolean, required
    - object: tiktok-cml-tracks
      - `tracks` object[], required
        - `commercialMusicId` string, required
        - `name` string, required
        - `artist` string, required
        - `durationSeconds` number, nullable, required
        - `thumbnailUrl` string, nullable, required
        - `previewUrl` string, nullable, required
        - `genres` string[], required
        - `rankPosition` number, nullable, required
        - `rankDelta` number, nullable, required
        - `fullDurationSongClip` object, nullable, required
          - `songClipId` string, nullable, required
          - `previewUrl` string, nullable, required
          - `durationSeconds` number, nullable, required
        - `trendingSongClip` object, nullable, required
          - `songClipId` string, nullable, required
          - `previewUrl` string, nullable, required
          - `durationSeconds` number, nullable, required
      - `countryCode` string, required
      - `genre` 'ALL' | 'ROCK' | 'POP' | 'LATIN' | 'METAL' | 'ELECTRONIC' | 'HIP_HOP/RAP' | 'ALTERNATIVE/INDIE' | 'FOLK' | 'R&B/SOUL' | 'COUNTRY' | 'CLASSICAL' | 'JAZZ' | 'REGGAE' | 'CHILDHOOD' | 'BLUES' | 'EASY_LISTENING' | 'NEW_AGE' | 'WORLD_MUSIC' | 'EXPERIMENTAL' | 'DEVOTIONAL' | 'CHINESE_TRADITION' | '8_BIT' | 'A_CAPPELLA' | 'AFRO-POP' | 'ALTERNATIVE_HIP_HOP' | 'ALTERNATIVE_ROCK' | 'AMBIENT' | 'ARABIC_POP' | 'BASS_HOUSE' | 'BGM' | 'BOOMBAP' | 'BOSSA_NOVA' | 'BRAZILIAN_FUNK_STYLE' | 'BUDDHIST_MUSIC' | 'CANTOPOP' | 'CELTIC_POP' | 'CHAMBER_MUSIC' | 'CHILL_BEATS' | 'CHILLOUT' | 'CHINESE_FOLK' | 'CHINESE_OPERA' | 'CHINESE_POP' | 'CHINESE_STYLE' | 'CHINOISERIE_ELECTRONIC' | 'CHINOISERIE_RAP' | 'CHRISTIAN_MUSIC' | 'CONTEMPORARY_R&B' | 'COUNTRY_POP' | 'DANCE_POP' | 'DISCO' | 'DJ' | 'DRUM&BASS' | 'DUBSTEP' | 'EDM' | 'EDM_TRAP' | 'ELECTRO_POP' | 'EPIC' | 'FOLK_POP' | 'FUNK' | 'FUTURE_BASS' | 'GOSPEL' | 'GUFENG_MUSIC' | 'HARD_ROCK' | 'HIP_HOUSE' | 'HOLIDAY_MUSIC' | 'HOUSE' | 'INDIAN_POP' | 'INDIE_FOLK' | 'INDIE_POP' | 'INDIE_ROCK' | 'INSTRUMENTAL_HIP_HOP' | 'INSTRUMENTAL_ROCK' | 'IRISH_FOLK' | 'J_ROCK' | 'JAPANESE_TRADITIONAL_MUSIC' | 'JAZZ_FUSION' | 'JAZZ_HIP_HOP' | 'JAZZ_POP' | 'J-POP' | 'K-POP' | 'LATIN_POP' | 'LO-FI' | 'MC' | 'NOISE' | 'OLD_SCHOOL' | 'OTHERS' | 'POP_RAP' | 'POP_ROCK' | 'POP_SOUL' | 'PSYCHEDELIC_ROCK' | 'PUNK' | 'R&B_RAP' | 'REGGAETON' | 'RUSSIAN_POP' | 'SERTANEJO' | 'SON_CUBANO' | 'SOUL' | 'SOUNDTRACK' | 'SYMPHONY' | 'SYNTH_POP' | 'TANGO' | 'TECHNO' | 'TEEN_POP' | 'TRADITIONAL_CHINESE_FOLK' | 'TRANCE' | 'TRAP_RAP' | 'TRIP_HOP' | 'TROPICAL_HOUSE' | 'TURKISH_POP', required
      - `dateRange` '1DAY' | '7DAY' | '30DAY' | '90DAY', required
    - object: locations
      - `locations` object[], required
        - `id` string, required
        - `name` string, required
        - `address` string, required
        - `latitude` number
        - `longitude` number
    - object: instagram-collaborators
      - `user` object, required
        - `id` string, required
        - `username` string, required
        - `name` string, required
        - `thumbnailUrl` string, required
    - object: instagram-audio
      - `audio` object[], required
        - `audio_id` string, required
        - `cover_artwork_thumbnail_uri` string, nullable
        - `cover_artwork_thumbnail_url` string, nullable
        - `display_artist` string, nullable
        - `duration_in_ms` number, nullable
        - `audio_type` string
        - `title` string, nullable
        - `download_url` string, nullable
        - `ig_username` string, nullable
        - `profile_picture_url` string, nullable
        - `is_ads_eligible` boolean, nullable
        - `on_platform_audio_preview_link` string, nullable
      - `paging` unknown
  - `meta` unknown, required

---

[API](https://skmtc.dev/maevesocial/apis/maeve-social-api.md) · [All operations](https://skmtc.dev/maevesocial/apis/maeve-social-api/llms.txt) · [OpenAPI document](https://skmtc.dev/maevesocial/apis/maeve-social-api/revisions/1b00fd7e4b15?raw)