---
title: "Bulk-protect creators from GMV Max auto-exclusion"
method: POST
path: "/gmv-max/protected-creators/import"
tags: ["GMV Max"]
---

# Bulk-protect creators from GMV Max auto-exclusion

`POST /gmv-max/protected-creators/import`

## Request

- Base URL: `https://api.reacherapp.com/public/v1`
- URL: `https://api.reacherapp.com/public/v1/gmv-max/protected-creators/import`
- Auth: API key in header `x-api-key` and API key in header `x-shop-id`

Add a list of creator handles to this shop's GMV Max allow-list in one call (an imported roster). Case-folded duplicates collapse; already-protected handles are counted in `already_protected`, not re-written. Each newly-protected creator also has any existing exclusion removed. Requires `read_write` scope and an `Idempotency-Key`. Single shop only.

## Headers

- `Idempotency-Key` string, nullable

## Request body

- GmvMaxImportProtectedCreatorsRequest: POST /gmv-max/protected-creators/import request body — bulk-protect a roster of creator handles (CORE-8128). Case-folded duplicates collapse; already-protected handles are counted, not re-written.
  - `handles` string[], required: TikTok handles to protect from auto-exclusion (max 10000 per call). Case variants of one handle are collapsed.

## Response `200`

Successful Response

- GmvMaxProtectImportResponse: POST /gmv-max/protected-creators/import.
  - `data` GmvMaxProtectImportResult, required
    - `requested` integer, required: How many handles were submitted.
    - `protected` string[], required: The handles newly added to the allow-list by this call.
    - `count` integer, required: Number of newly-protected handles.
    - `already_protected` integer, required: Valid handles that were already on the allow-list (no-op).

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `409`: Conflict
- `422`: Unprocessable Entity
- `429`: Too Many Requests
- `500`: Internal Server Error

## Changes

> 76 revisions in range; 1 not diffed.

- **2026-09-29** `c8958a7038ec`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/reacherapp/apis/reacher-data-api/changes/gmv-max/protected-creators/import/post.md)

---

[API](https://skmtc.dev/reacherapp/apis/reacher-data-api.md) - [All operations](https://skmtc.dev/reacherapp/apis/reacher-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/reacherapp/apis/reacher-data-api/revisions/63ce74b30b5a?raw)