---
title: "Add creators to the shop's do-not-contact list"
method: POST
path: "/shops/blacklist"
tags: ["Targets & Blacklist"]
---

# Add creators to the shop's do-not-contact list

`POST /shops/blacklist`

Blacklist one or more creators so outreach automations stop targeting them.

Handles are normalized before storage (a leading `@` and surrounding whitespace are stripped, the handle is lowercased), so `@Creator` and `creator` are the same entry. The call is additive and forgiving: handles already on the list are counted in `duplicates_skipped`, malformed handles (URLs, blanks) in `invalid_skipped` — neither fails the request, so a partially valid batch still applies. Check `added_count` for what actually changed.

At most 500 handles per request. Requires a key with `read_write` scope and a single shop.

## Request body

- BlacklistAddRequest — Creators to add to the shop's do-not-contact list.
  - `creators` string[], required — Creator handles. A leading `@` and surrounding whitespace are stripped and the handle is lowercased before storage. URLs are rejected. Duplicates within the request and handles already on the list are skipped, not errors.

## Response `200`

Successful Response

- BlacklistAddResponse — Outcome of an add — partial success is normal, not an error.
  - `added_count` integer, required — Handles newly blacklisted.
  - `duplicates_skipped` integer, required — Handles already on the list, left untouched.
  - `invalid_skipped` integer, required — Handles rejected as malformed (URLs, blanks).
  - `invalid_creators` string[] — The rejected handles, as submitted.
  - `message` string, required — Human-readable summary of the outcome.

## Other responses

- `422` — Validation Error

---

[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-service-production.skmtc.workers.dev/v1/apis/reacherapp/reacher-data-api/revisions/5eefff009b5b/schema)