---
title: "Add A Creator Endpoint"
method: POST
path: "/api/v1/remy/add-a-creator"
tags: ["remy"]
---

# Add A Creator Endpoint

`POST /api/v1/remy/add-a-creator`

## Request

- Base URL: `https://api.brandbooster.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.brandbooster.ai/api/v1/remy/add-a-creator`
- Auth: HTTP bearer

Add a creator to the roster — manual entry, or fetch by username/profile/reel link.

## Request body

- AddCreatorRequestDTO
  - `platform` 'instagram' | 'youtube' | 'tiktok', required
  - `mode` 'manual' | 'fetch', required
  - `profiles` string[], nullable
  - `manual_entries` ManualCreatorEntryDTO[], nullable
    - `username` string, required
    - `full_name` string, nullable
    - `followers` integer, nullable
    - `category` string, nullable
    - `subcategory` string, nullable
    - `email` string, email, nullable
    - `email_kind` string, nullable
    - `bio_text` string, nullable
    - `country` string, nullable
    - `posts_total` integer, nullable
    - `avg_likes` integer, nullable
    - `avg_comments` integer, nullable
    - `engagement_rate` number, nullable
    - `median_views` integer, nullable
    - `views_followers_ratio` number, nullable
    - `posts_per_month` number, nullable
    - `posts_last_30` integer, nullable
    - `last_post_days` integer, nullable
    - `reels_count` integer, nullable
    - `last_reel_days` integer, nullable
    - `external_url` string, nullable
    - `profile_pic_url` string, nullable
    - `is_verified` boolean, nullable
    - `avg_views` integer, nullable

## Response `200`

Successful Response

- ReachoutScrapeRunResponseDTO
  - `run_id` string, required
  - `dataset_id` string, required
  - `status` string, nullable
  - `mode` string, required
  - `params` object, nullable
  - `keywords` string[], nullable
  - `cached` boolean
  - `cached_count` integer
  - `params_key` string, nullable

## Other responses

- `422`: Validation Error

## Changes

> 36 revisions in range; 1 not diffed.

- **2026-09-16** `dda5cf04b73d`: 1 info
  - added the new optional request property `manual_entries/anyOf[subschema #1]/items/subcategory`
- **2026-09-11** `163530d84bc1`: 1 info
  - added the new `tiktok` enum value to the request property `platform`

[Operation history](https://skmtc.dev/brandbooster/apis/brandbooster-api/changes/api/v1/remy/add-a-creator/post.md)

---

[API](https://skmtc.dev/brandbooster/apis/brandbooster-api.md) - [All operations](https://skmtc.dev/brandbooster/apis/brandbooster-api/llms.txt) - [OpenAPI document](https://skmtc.dev/brandbooster/apis/brandbooster-api/revisions/f84fc05f417b?raw)