> ## Documentation Index > Fetch the complete documentation index at: https://docs.creatordb.app/llms.txt > Use this file to discover all available pages before exploring further. # Submit creators > Add new creators to CreatorDB's database by user ID and social media platform type. This feature supports adding creators from YouTube, Instagram, and TikTok. Currently, this only shows if the submission is successful. ## OpenAPI ````yaml /api-v2/api-v2.yaml post /submitCreators openapi: 3.1.0 info: version: '2' title: CreatorDB Headless APIService description: >- Generated from swaggerComponentIndex.json by core-types-json-schema (https://github.com/grantila/core-types-json-schema). Use OpenAPI 3.1.0 version with direct JSON Schema support termsOfService: https://www.creatordb.app contact: name: CreatorDB url: https://www.creatordb.app email: support@creatordb.app license: url: http://www.apache.org/licenses/LICENSE-2.0.html name: Apache 2.0 x-id: indexForSwagger.yaml servers: - url: https://dev.creatordb.app/v2 description: CreatorDB API Endpoint - prod version security: [] tags: - name: General Operations description: >- General-purpose endpoints such as API status, content retrieval, and cross-platform operations - name: YouTube description: >- YouTube creator data endpoints including basic metrics, historical data, and detailed analytics - name: Instagram description: >- Instagram creator data endpoints with metrics and advanced search capabilities - name: TikTok description: >- TikTok creator data endpoints with metrics and advanced search functionality - name: Threads description: Threads creator data endpoints with basic metrics and historical data - name: Facebook description: Facebook creator data endpoints with metrics and search capabilities - name: Topic description: Topic-based analysis and reporting endpoints for content categorization - name: Brand description: Brand analysis endpoints including sponsor search and brand reports - name: Niches description: Niche-related endpoints for content category analysis and related searches paths: /submitCreators: post: tags: - General Operations summary: Submit creators description: >- Add new creators to CreatorDB's database by user ID and social media platform type. This feature supports adding creators from YouTube, Instagram, and TikTok. Currently, this only shows if the submission is successful. operationId: submitCreators parameters: - name: apiId in: header description: '' required: true schema: type: string examples: - LE6DPZQkR3TQShxofXoD2j8qCBu1-f0jti665m1t50dwDD12W requestBody: description: submit database non existed creators required: true content: application/json: schema: $ref: '#/components/schemas/SubmitCreatorsParams' examples: default: value: platform: youtube platformUserIds: - UCm-X6o81nRsXQTmqpyArkBQ responses: '200': description: OK content: application/json: schema: type: object properties: data: type: array items: type: string quotaUsed: type: number description: API credits that were used to make this call. quotaUsedTotal: type: number description: Total API credits used since the last billing cycle. remainingPlanCredit: type: number description: >- The number of remaining free API credits that come with your subscription plan. These API credits are renewed every billing cycle. remainingPrepurchasedCredit: type: number description: >- The number of remaining extra purchased API credits. These API credits do not expire until used. timestamp: type: number description: >- Unix timestamp of the call request that the server received. error: type: string description: Errors that occurred during the API call. success: type: boolean description: It is TRUE when the call is successful. examples: default: value: data: [] quotaUsed: 0 quotaUsedTotal: 6024 remainingPlanCredit: 993976 remainingPrepurchasedCredit: 0 timestamp: 1755503515301 error: '' success: true '403': description: Forbidden content: application/json: schema: type: object properties: data: type: array items: type: string quotaUsed: type: number description: API credits that were used to make this call. quotaUsedTotal: type: number description: Total API credits used since the last billing cycle. remainingPlanCredit: type: number description: >- The number of remaining free API credits that come with your subscription plan. These API credits are renewed every billing cycle. remainingPrepurchasedCredit: type: number description: >- The number of remaining extra purchased API credits. These API credits do not expire until used. timestamp: type: number description: >- Unix timestamp of the call request that the server received. error: type: string description: Errors that occurred during the API call. success: type: boolean description: It is TRUE when the call is successful. examples: default: value: data: null quotaUsed: 0 quotaUsedTotal: 0 remainingPlanCredit: 0 remainingPrepurchasedCredit: 0 timestamp: 1755503514055 error: APIKeyNotMatch success: false servers: - url: https://dev.creatordb.app/v2 description: CreatorDB API Endpoint - prod version x-codeSamples: - lang: bash label: cURL source: | curl --request POST \ --url https://dev.creatordb.app/v2/submitCreators \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --header 'apiId: LE6DPZQkR3TQShxofXoD2j8qCBu1-f0jti665m1t50dwDD12W' \ --data '{ "platform": "youtube", "platformUserIds": [ "UCm-X6o81nRsXQTmqpyArkBQ" ] }' components: schemas: SubmitCreatorsParams: type: object description: >- The parameters required for submitting new creators to the CreatorDB database via an API call. additionalProperties: false properties: platform: $ref: '#/components/schemas/Platform' description: The social media platform that the creator uses or is active on. platformUserIds: type: array description: >- The creator's user ID on a specific social media platform, such as YouTube, Instagram, or TikTok. items: type: string required: - platform - platformUserIds Platform: type: string enum: - youtube - instagram - tiktok ````