Corporate Holder

Create Corporate Holders

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.

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

Request body

namestring required

Card holder name. Example: "Iron Bank S.A.".

centerIdstring

Id of the target cost center. Example: "5656565656565656".

permissionsstring[]

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"}]

rulesstring[]

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"}]

tagsstring[]

Array of up to 100 strings to tag the entity for future queries. All tags will be converted to lowercase.

expandstring

Fields to return expanded in the response. Options: "rules", "centerName".

Response

Successful operation

object required

Changes

No recorded changes to this operation across all 1 revision of this API.