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

# Add A Creator Endpoint

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

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

## Request body

- AddCreatorRequestDTO
  - `platform` 'instagram' | 'youtube', 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
    - `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

---

[API](https://skmtc.dev/brandbooster/apis/fastapi.md) · [All operations](https://skmtc.dev/brandbooster/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/brandbooster/fastapi/revisions/ff7f2b621b41/schema)