---
title: "Create Corporate Holders"
method: POST
path: "/v2/corporate-holder"
tags: ["Corporate Holder"]
---

# Create Corporate Holders

`POST /v2/corporate-holder`

## Request

- Base URL: `https://api.starkbank.com`
- URL: `https://api.starkbank.com/v2/corporate-holder`
- Auth: API key in header `Digital-Signature`

Use this route to create up to 100 new corporate holders at a time.
NOTE:Holder names must be unique among the active holders of your Workspace. Creating a holder with the name of another active holder will be rejected.

## Request body

- object
  - `name` string, required: Card holder name. Example: "Iron Bank S.A.".
  - `centerId` string: Id of the target cost center. Example: "5656565656565656".
  - `permissions` string[]: Array of permission objects granting access to this holder. Each object requires an ownerType and an ownerId. Example: [{"ownerType": "project", "ownerId": "6253551860842496"}, {"ownerType": "member", "ownerId": "6227829385592832"}]
  - `rules` string[]: Array of rule objects with the spending rules that will apply to every card bound to this holder. Example: [{"name": "General USD", "interval": "day", "amount": 100000, "currencyCode": "USD"}]
  - `tags` string[]: Array of up to 100 strings to tag the entity for future queries. All tags will be converted to lowercase.
  - `expand` string: Fields to return expanded in the response. Options: "rules", "centerName".

## Response `200`

Successful operation

- object

## Other responses

- `400`: Client error
- `500`: Server error

---

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