---
updatedAt: 2026-04-21T09:29:18.000Z
agentTools:
  projectIndex: https://partner.getpliant.com/llms.txt
---

# Create Card Account

> 🔒 **Required scope:** `financial-accounts:write`
>
> The API credential calling this endpoint must be granted the `financial-accounts` category with `read & write` access.
> Scopes are assigned to the credential when it is created or edited in Pliant, not requested when obtaining the access token.
> A credential without this scope receives `403 Forbidden` with the error code `INSUFFICIENT_PERMISSION`.

Creates a new card account for the specified organization.


# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "contact": {
      "name": "API Support",
      "email": "support@getpliant.com",
      "url": "https://www.getpliant.com"
    },
    "title": "Pliant Partner API",
    "description": "Pliant Partner API",
    "version": "2.1.0",
    "license": {
      "name": "MIT",
      "url": "https://opensource.org/license/MIT"
    }
  },
  "servers": [
    {
      "url": "https://partner-api.getpliant.com/api",
      "description": "Pliant Production Server"
    },
    {
      "url": "https://sandbox.partner-api.getpliant.com/api",
      "description": "Pliant Sandbox Server"
    },
    {
      "url": "https://pci-api.getpliant.com",
      "description": "PCI Vault Production Server"
    },
    {
      "url": "https://pci-sandbox.partner-api.getpliant.com",
      "description": "PCI Vault Sandbox Server"
    }
  ],
  "x-readme": {
    "explorer-enabled": false,
    "samples-languages": [
      "curl",
      "java",
      "kotlin"
    ],
    "headers": [
      {
        "key": "Pliant-API-Version",
        "value": "2.1.0"
      }
    ]
  },
  "tags": [
    {
      "name": "Card Accounts",
      "description": "This tag is for operations related to card accounts"
    }
  ],
  "paths": {
    "/card-accounts": {
      "post": {
        "summary": "Create Card Account",
        "description": "> 🔒 **Required scope:** `financial-accounts:write`\n>\n> The API credential calling this endpoint must be granted the `financial-accounts` category with `read & write` access.\n> Scopes are assigned to the credential when it is created or edited in Pliant, not requested when obtaining the access token.\n> A credential without this scope receives `403 Forbidden` with the error code `INSUFFICIENT_PERMISSION`.\n\nCreates a new card account for the specified organization.\n",
        "x-required-scopes": [
          "financial-accounts:write"
        ],
        "tags": [
          "Card Accounts"
        ],
        "operationId": "create-card-account",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "organizationId",
                  "name"
                ],
                "properties": {
                  "organizationId": {
                    "type": "string",
                    "format": "uuid",
                    "description": "The unique identifier of the organization."
                  },
                  "name": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 255,
                    "description": "The name of the card account."
                  },
                  "currency": {
                    "type": "string",
                    "description": "The currency code (e.g., EUR, USD).",
                    "nullable": true
                  }
                }
              },
              "examples": {
                "example-1": {
                  "value": {
                    "organizationId": "123e4567-e89b-12d3-a456-426614174000",
                    "name": "EURO Main",
                    "currency": "EUR"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Card account created successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CardAccount"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400"
          },
          "401": {
            "$ref": "#/components/responses/401"
          },
          "403": {
            "$ref": "#/components/responses/403"
          },
          "409": {
            "$ref": "#/components/responses/409"
          },
          "429": {
            "$ref": "#/components/responses/429"
          },
          "500": {
            "$ref": "#/components/responses/500"
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "description": "This API uses oAuth2 with client credentials flow to [obtain the Bearer Token](/docs/authenticated-api-usage).",
        "bearerFormat": "JWT"
      }
    },
    "schemas": {
      "CardAccount": {
        "type": "object",
        "required": [
          "id",
          "organizationId",
          "name",
          "status",
          "currency",
          "paymentFrequency",
          "paymentDefermentInDays",
          "defaultAccount",
          "accountType",
          "createdAt"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "The id of the card account."
          },
          "organizationId": {
            "type": "string",
            "format": "uuid",
            "description": "The id of the organization this card account belongs to."
          },
          "name": {
            "type": "string",
            "description": "The name of the card account."
          },
          "purpose": {
            "type": "string",
            "nullable": true,
            "description": "Optionally, a description of the purpose of the card account."
          },
          "status": {
            "type": "string",
            "description": "The status of the card account.\n  - `ACTIVE` - the card account is operational.\n  - `PENDING` - the card account is not operational yet, e.g. because the organization is still onboarding.\n  - `DEACTIVATED` - the card account was deactivated and can no longer be used.\n  - `CANCELLED` - the card account was cancelled.\n  - `SUPERSEDED` - the card account was replaced by a successor card account and is kept for historical reasons only.\n    It stays readable, but no new cards, payments or payouts can be created on it. The successor is referenced by `supersededBy`.\n    See the [card account guide](/docs/card-account) for details.\n",
            "enum": [
              "ACTIVE",
              "PENDING",
              "DEACTIVATED",
              "CANCELLED",
              "SUPERSEDED"
            ]
          },
          "currency": {
            "type": "string",
            "description": "The currency of the card account."
          },
          "bankAccountInformation": {
            "type": "array",
            "description": "The Pliant-internal bank account information of the card account. This is the bank account where the balance of the card account is kept. This bank account is also used for adding top-up payments to the card account, if it is a prefund or hybrid card account. One card account can have multiple bank accounts. Non-active organizations might not have bank account information. The bank account is Pliant-internal, for the external bank account information see the [separate endpoint](/reference/get-organizations-external-bank-accounts).",
            "items": {
              "type": "object",
              "properties": {
                "transferType": {
                  "type": "string",
                  "description": "Flag that indicates which payment rail the processing account is configured for.\n  - `SWIFT` - transfers routed through the SWIFT network.\n  - `LOCAL` - domestic rails such as UK's Faster Payments.\nDepending on this flag, other fields are set or not, e.g. `bic` and `iban` for `SWIFT`, `sortCode` and `accountNumber` for `LOCAL` in case of UK Faster Payments.\nThe field might be `null` or empty, in which case `SWIFT` should be assumed.\n"
                },
                "beneficiary": {
                  "type": "string",
                  "description": "The beneficiary of the bank account. This is the name of the account holder."
                },
                "bankName": {
                  "type": "string",
                  "description": "The name of the bank of the bank account."
                },
                "bic": {
                  "type": "string",
                  "description": "The BIC of the bank account. This is the bank identifier code. For backward compatibility reasons this field is never `null`, but depending on `transferType` it can be empty. In future iterations it will become optional."
                },
                "iban": {
                  "type": "string",
                  "description": "The IBAN of the bank account. This is the international bank account number. For backward compatibility reasons this field is never `null`, but depending on `transferType` it can be empty. In future iterations it will become optional."
                },
                "sortCode": {
                  "type": "string",
                  "description": "Bank identifier that accompanies the beneficiary account. Only set for certain `transferType` values, e.g. UK Faster Payments."
                },
                "accountNumber": {
                  "type": "string",
                  "description": "Account identifier for the beneficiary account. Only set for certain `transferType` values, e.g. UK Faster Payments."
                }
              }
            }
          },
          "defaultAccount": {
            "type": "boolean",
            "description": "Indicates whether this is the default card account. There is always one active default card account."
          },
          "accountType": {
            "type": "string",
            "description": "The account type of the card account.",
            "enum": [
              "CREDIT",
              "PREFUNDED"
            ]
          },
          "creditLimit": {
            "type": "object",
            "nullable": true,
            "description": "The credit limit of the card account. The credit limit is the maximum amount of money that can be spent with all cards of this card account. It is always less or equal to the overall credit limit of the organization. Meaning all card accounts share the same organization credit limit. This organization credit limit can be distributed among the card accounts. Only relevant for `CREDIT`-based card accounts.",
            "properties": {
              "value": {
                "type": "number"
              },
              "currency": {
                "type": "string"
              }
            }
          },
          "availableLimit": {
            "type": "object",
            "nullable": true,
            "description": "The remaining available credit limit of the card account. The available credit limit is the maximum amount of money that can be spent with all cards of this card account. For `PREFUNDED` card accounts, the available credit limit is the remaining balance of the card account.",
            "properties": {
              "value": {
                "type": "number"
              },
              "currency": {
                "type": "string"
              }
            }
          },
          "balance": {
            "type": "object",
            "nullable": true,
            "description": "The remaining balance of the card account.",
            "properties": {
              "value": {
                "type": "number"
              },
              "currency": {
                "type": "string"
              }
            }
          },
          "paymentFrequency": {
            "type": "string",
            "description": "The payment frequency of the card account. This is the frequency with which the card account is settled for this organization. Only relevant for `CREDIT`-based card accounts.",
            "enum": [
              "DAILY",
              "WEEKLY",
              "BI_WEEKLY",
              "MONTHLY",
              "PREFUNDED"
            ]
          },
          "paymentDefermentInDays": {
            "type": "integer",
            "description": "The payment deferment in days of the card account. Only relevant for `CREDIT`-based card accounts."
          },
          "activatedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "description": "The date and time when the card account was activated."
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "description": "The date and time when the card account was created."
          },
          "supersededBy": {
            "type": "string",
            "format": "uuid",
            "nullable": true,
            "description": "The id of the card account that took over from this one. Only set if this card account has `status` `SUPERSEDED`, `null` otherwise. Follow this id to find the card account that holds the current balance, limits and bank account information."
          },
          "supersedes": {
            "type": "string",
            "format": "uuid",
            "nullable": true,
            "description": "The id of the card account this one took over from. Only set if this card account is the successor of a superseded card account, `null` otherwise. The superseded card account remains readable and keeps its historical transactions, statements and account entries."
          },
          "supersededAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "description": "The date and time when this card account was superseded. Only set together with `supersededBy`, `null` otherwise."
          },
          "benefitCardAccount": {
            "type": "boolean",
            "description": "Set to true for the card account that is dedicated to funding benefit cards."
          }
        }
      },
      "Error": {
        "type": "object",
        "properties": {
          "errorCode": {
            "type": "string",
            "description": "The error code"
          },
          "exceptionId": {
            "type": "string",
            "format": "uuid",
            "description": "The id of the exception that was thrown"
          },
          "message": {
            "type": "string",
            "description": "The cause of the error or further explanations on the error"
          }
        }
      }
    },
    "responses": {
      "400": {
        "description": "Bad Request. The API consumer sent a malformed request which could not be processed.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      },
      "401": {
        "description": "Unauthorized. The API consumer is not authorized to access the requested resource.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      },
      "403": {
        "description": "Forbidden. The API consumer is not allowed to access the requested resource.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      },
      "409": {
        "description": "Conflict. The request could not be completed due to a conflict with the current state of the resource. You may retry the call.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      },
      "429": {
        "description": "Too Many Requests. The API consumer has sent too many requests in a given amount of time. Please check our [API guidelines](/docs/pliant-api-guidelines#api-rate-limits).",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "error": {
                  "type": "string",
                  "description": "Detailed description of the error and breached rate limit."
                }
              }
            }
          }
        }
      },
      "500": {
        "description": "Internal Server Error. The request was not completed due to an internal error.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      }
    }
  },
  "security": [
    {
      "bearerAuth": []
    }
  ]
}
```