---
title: "Create blocklist entries in bulk"
method: POST
path: "/payins-blocklist/bulk"
tags: ["Payins Blocklist"]
---

# Create blocklist entries in bulk

`POST /payins-blocklist/bulk`

Creates one or more blocklist entries for the authenticated fin. Each block identifies a single account to block by account type and account number. Blocks are grouped by account type and inserted atomically per group. If any block has an invalid structure, the entire request is rejected and nothing is inserted. Note that changes to the blocklist may take up to 5 minutes to take effect.

## Request body

- object
  - `blocks` object[], required — List of blocks to create. May be empty.
    - `criteria` BlocklistBlockCriteria, required — Matching criteria that identifies an account to block.
      - `creditor` object, required
        - `account_type` string, required — The type of account number (e.g. `clabe`, `cuenta`).
        - `account` string, required — The account number to block.

## Response `201`

Entries created successfully. Only newly inserted entries are returned — accounts that were already blocked are omitted.

- object
  - `blocks` BlocklistBlock[]
    - `id` integer — Unique identifier of the blocklist entry.
    - `criteria` BlocklistBlockCriteria — Matching criteria that identifies an account to block.
      - `creditor` object, required
        - `account_type` string, required — The type of account number (e.g. `clabe`, `cuenta`).
        - `account` string, required — The account number to block.
    - `created_at` string, date-time — ISO 8601 timestamp of when the entry was created.

## Other responses

- `400` — Missing `blocks` parameter or one or more blocks have an invalid structure.
- `403` — Forbidden (e.g: wrong API Key)
- `422` — Service error during insertion.

---

[API](https://skmtc.net/shinkansen/apis/payouts-shinkansen-endpoints.md) · [All operations](https://skmtc.net/shinkansen/apis/payouts-shinkansen-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shinkansen/payouts-shinkansen-endpoints/versions/1e4a6760b7e8/schema)