---
updatedAt: 2026-06-04T16:54:59.000Z
agentTools:
projectIndex: https://doc.fintecture.com/llms.txt
---
# Create Customer Bank Account
Create Customer Bank Account
# OpenAPI definition
```json
{
"openapi": "3.0.3",
"info": {
"title": "API EXPLORER",
"version": "3.0.0",
"description": "Public API\n",
"contact": {
"name": "Support",
"email": "noelia.rodriguez@fintecture.com"
}
},
"x-readme": {
"explorer-enabled": false,
"proxy-enabled": false,
"samples-languages": [
"curl",
"javascript",
"ruby"
]
},
"servers": [
{
"url": "https://api.sandbox.fintecture.com",
"description": "Sandbox server"
},
{
"url": "https://api.fintecture.com",
"description": "Production server"
}
],
"paths": {
"/v1/customers/{customer_id}/bank_accounts": {
"post": {
"security": [
{
"OAuth2Customers": [
"customers"
]
}
],
"requestBody": {
"$ref": "#/components/requestBodies/BankAccountV1CreationRequest"
},
"tags": [
"customers"
],
"parameters": [
{
"$ref": "#/components/parameters/Header-digest-req"
},
{
"$ref": "#/components/parameters/Header-signature-req"
},
{
"$ref": "#/components/parameters/Header-date-req"
},
{
"$ref": "#/components/parameters/Header-xRequestId-req"
}
],
"responses": {
"201": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/BankAccountV1"
}
}
},
"description": "successful operation"
},
"400": {
"$ref": "#/components/responses/400-BadRequest"
},
"401": {
"$ref": "#/components/responses/401-Unauthorized"
},
"403": {
"$ref": "#/components/responses/403-Forbidden"
},
"406": {
"$ref": "#/components/responses/406-NotAcceptable"
},
"500": {
"$ref": "#/components/responses/500-InternalServerError"
}
},
"operationId": "createCustomerBankAccount",
"summary": "Create Customer Bank Account",
"description": "Create Customer Bank Account"
},
"parameters": [
{
"$ref": "#/components/parameters/Path-customerId-req"
}
]
}
},
"components": {
"parameters": {
"Header-date-req": {
"name": "date",
"description": "RFC2822 formatted date.",
"schema": {
"$ref": "#/components/schemas/DateRfc2822"
},
"in": "header",
"required": true
},
"Header-signature-req": {
"name": "signature",
"description": "Signature is used to enforce security by signing request.
Related documentation can be found by clicking [here](https://doc.fintecture.com/docs/api-http-signature)",
"schema": {
"type": "string"
},
"in": "header",
"required": true
},
"Header-digest-req": {
"name": "digest",
"description": "Sha-256 base64 encoded digest.
Related documentation can be found by clicking [here](https://doc.fintecture.com/docs/api-http-signature)",
"schema": {
"type": "string"
},
"in": "header",
"required": true
},
"Header-xRequestId-req": {
"name": "x-request-id",
"description": "uuid v4. Required in Redirect mode.",
"schema": {
"$ref": "#/components/schemas/IdentifierUuidV4"
},
"in": "header",
"required": true
},
"Path-customerId-req": {
"name": "customer_id",
"description": "Customer identifier as returned on customer creation",
"schema": {
"$ref": "#/components/schemas/IdentifierUuidV4"
},
"in": "path",
"required": true
}
},
"requestBodies": {
"BankAccountV1CreationRequest": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/BankAccountV1CreationRequest"
}
}
},
"required": true
}
},
"responses": {
"400-BadRequest": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/APIResponse400"
}
}
},
"description": "bad request"
},
"401-Unauthorized": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/APIResponse401"
}
}
},
"description": "unauthorized"
},
"403-Forbidden": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/APIResponse403"
}
}
},
"description": "forbidden"
},
"406-NotAcceptable": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/APIResponse406"
}
}
},
"description": "not acceptable"
},
"500-InternalServerError": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/APIResponse500"
}
}
},
"description": "internal server error"
}
},
"schemas": {
"APIResponse400": {
"title": "400 API Response",
"description": "Definition of the standard API reponse when a 400",
"type": "object",
"properties": {
"status": {
"format": "int32",
"description": "HTTP status code",
"type": "integer",
"example": 400
},
"code": {
"type": "string",
"enum": [
"bad_request",
"provider_error"
],
"example": "bad_request"
},
"log_id": {
"allOf": [
{
"$ref": "#/components/schemas/IdentifierUuidV4"
},
{
"description": "Log unique identifier"
}
]
},
"errors": {
"description": "Errors returned",
"type": "array",
"items": {
"$ref": "#/components/schemas/APIResponse400Error"
}
}
}
},
"APIResponse400Error": {
"title": "API Response 400 Error",
"description": "API Response 400 Error description",
"type": "object",
"properties": {
"code": {
"type": "string",
"enum": [
"bad_request",
"customer_unknown",
"account_unknown",
"session_id_invalid_or_expired",
"invalid_field",
"mandatory_field_missing",
"invalid_debited_account"
],
"example": "bad_request"
},
"title": {
"description": "Title message",
"type": "string",
"example": "Bad request"
},
"message": {
"description": "Error message",
"type": "string",
"example": "Invalid parameters or malformed syntax."
}
}
},
"APIResponse401": {
"title": "401 API Response",
"description": "Definition of the standard API reponse when a 401",
"type": "object",
"properties": {
"status": {
"format": "int32",
"description": "HTTP status code",
"type": "integer",
"example": 401
},
"code": {
"type": "string",
"enum": [
"unauthorized"
],
"example": "unauthorized"
},
"log_id": {
"allOf": [
{
"$ref": "#/components/schemas/IdentifierUuidV4"
},
{
"description": "Log unique identifier"
}
]
},
"errors": {
"description": "Errors returned",
"type": "array",
"items": {
"$ref": "#/components/schemas/APIResponse401Error"
}
}
}
},
"APIResponse401Error": {
"title": "API Response 401 Error",
"description": "API Response 401 Error description",
"type": "object",
"properties": {
"code": {
"type": "string",
"enum": [
"invalid_token",
"invalid_scopes",
"invalid_code",
"invalid_app_id",
"invalid_app_url"
],
"example": "bad_request"
},
"title": {
"description": "Title message",
"type": "string",
"example": "Invalid token"
},
"message": {
"description": "Error message",
"type": "string",
"example": "The token is either invalid or expired."
}
}
},
"APIResponse403": {
"title": "403 API Response",
"description": "Definition of the standard API reponse when a 403",
"type": "object",
"properties": {
"status": {
"format": "int32",
"description": "HTTP status code",
"type": "integer",
"example": 403
},
"code": {
"type": "string",
"enum": [
"forbidden"
],
"example": "forbidden"
},
"log_id": {
"allOf": [
{
"$ref": "#/components/schemas/IdentifierUuidV4"
},
{
"description": "Log unique identifier"
}
]
},
"errors": {
"description": "Errors returned",
"type": "array",
"items": {
"$ref": "#/components/schemas/APIResponse403Error"
}
}
}
},
"APIResponse403Error": {
"title": "API Response 403 Error",
"description": "API Response 403 Error description",
"type": "object",
"properties": {
"code": {
"type": "string",
"enum": [
"forbidden"
],
"example": "forbidden"
},
"title": {
"description": "Title message",
"type": "string",
"example": "Forbidden"
},
"message": {
"description": "Error message",
"type": "string",
"example": "Access Forbidden."
}
}
},
"APIResponse406": {
"title": "406 API Response",
"description": "Definition of the standard API reponse when a 406",
"type": "object",
"properties": {
"status": {
"format": "int32",
"description": "HTTP status confirmation",
"type": "integer",
"example": 406
},
"code": {
"type": "string",
"enum": [
"ERR_NOT_ACCEPTABLE"
],
"example": "ERR_NOT_ACCEPTABLE"
},
"log_id": {
"allOf": [
{
"$ref": "#/components/schemas/IdentifierUuidV4"
},
{
"description": "Log unique identifier"
}
]
},
"errors": {
"description": "Errors returned",
"type": "array",
"items": {
"$ref": "#/components/schemas/APIResponse406Error"
}
}
}
},
"APIResponse406Error": {
"title": "API Response 406 Error",
"description": "API Response 406 Error description",
"type": "object",
"properties": {
"code": {
"type": "string",
"enum": [
"SCHEMA_VALIDATION_ERROR"
],
"example": "SCHEMA_VALIDATION_ERROR"
},
"title": {
"description": "Title message",
"type": "string",
"example": "Schema validation error"
},
"detail": {
"description": "Error message",
"type": "string",
"example": "must NOT have fewer than 1 characters"
}
}
},
"APIResponse500": {
"title": "500 API Response",
"description": "Definition of the standard API reponse when a 500",
"type": "object",
"properties": {
"status": {
"format": "int32",
"description": "HTTP status code",
"type": "integer",
"example": 500
},
"code": {
"type": "string",
"enum": [
"internal_server_error"
],
"example": "internal_server_error"
},
"log_id": {
"allOf": [
{
"$ref": "#/components/schemas/IdentifierUuidV4"
},
{
"description": "Log unique identifier"
}
]
},
"errors": {
"description": "Errors returned",
"type": "array",
"items": {
"$ref": "#/components/schemas/APIResponse500Error"
}
}
}
},
"APIResponse500Error": {
"title": "API Response 500 Error",
"description": "API Response 500 Error description",
"type": "object",
"properties": {
"code": {
"type": "string",
"enum": [
"internal_server_error"
],
"example": "internal_server_error"
},
"title": {
"description": "Title message",
"type": "string",
"example": "Internal Server Error"
},
"message": {
"description": "Error message",
"type": "string",
"example": "An internal error has occurred. If the error persists, please contact our support."
}
}
},
"BankIban": {
"title": "Bank IBAN",
"description": "IBAN of bank",
"type": "string",
"example": "FR1420041010050500013M02606",
"pattern": "^AL\\d{10}[0-9A-Z]{16}$|^AD\\d{10}[0-9A-Z]{12}$|^AT\\d{18}$|^BH\\d{2}[A-Z]{4}[0-9A-Z]{14}$|^BE\\d{14}$|^BA\\d{18}$|^BG\\d{2}[A-Z]{4}\\d{6}[0-9A-Z]{8}$|^HR\\d{19}$|^CY\\d{10}[0-9A-Z]{16}$|^CZ\\d{22}$|^DK\\d{16}$|^FO\\d{16}$|^GL\\d{16}$|^DO\\d{2}[0-9A-Z]{4}\\d{20}$|^EE\\d{18}$|^FI\\d{16}$|^FR\\d{12}[0-9A-Z]{11}\\d{2}$|^GE\\d{2}[A-Z]{2}\\d{16}$|^DE\\d{20}$|^GI\\d{2}[A-Z]{4}[0-9A-Z]{15}$|^GR\\d{9}[0-9A-Z]{16}$|^HU\\d{26}$|^IS\\d{24}$|^IE\\d{2}[A-Z]{4}\\d{14}$|^IL\\d{21}$|^IT\\d{2}[A-Z]\\d{10}[0-9A-Z]{12}$|^[A-Z]{2}\\d{5}[0-9A-Z]{13}$|^KW\\d{2}[A-Z]{4}22!$|^LV\\d{2}[A-Z]{4}[0-9A-Z]{13}$|^LB\\d{6}[0-9A-Z]{20}$|^LI\\d{7}[0-9A-Z]{12}$|^LT\\d{18}$|^LU\\d{5}[0-9A-Z]{13}$|^MK\\d{5}[0-9A-Z]{10}\\d{2}$|^MT\\d{2}[A-Z]{4}\\d{5}[0-9A-Z]{18}$|^MR13\\d{23}$|^MU\\d{2}[A-Z]{4}\\d{19}[A-Z]{3}$|^MC\\d{12}[0-9A-Z]{11}\\d{2}$|^ME\\d{20}$|^NL\\d{2}[A-Z]{4}\\d{10}$|^NO\\d{13}$|^PL\\d{10}[0-9A-Z]{,16}n$|^PT\\d{23}$|^RO\\d{2}[A-Z]{4}[0-9A-Z]{16}$|^SM\\d{2}[A-Z]\\d{10}[0-9A-Z]{12}$|^SA\\d{4}[0-9A-Z]{18}$|^RS\\d{20}$|^SK\\d{22}$|^SI\\d{17}$|^ES\\d{22}$|^SE\\d{22}$|^CH\\d{7}[0-9A-Z]{12}$|^TN59\\d{20}$|^TR\\d{7}[0-9A-Z]{17}$|^AE\\d{21}$|^GB\\d{2}[A-Z]{4}\\d{14}$"
},
"Bic": {
"title": "BIC",
"description": "BIC",
"type": "string",
"example": "CMCIFR2AXXX"
},
"DateRfc2822": {
"title": "Date in rfc 2822 format",
"description": "Date as described in rfc 2822 format",
"type": "string",
"example": "Thu, 18 Jun 2020 18:14:15 GMT"
},
"DateIso8601": {
"title": "Date in iso 8601 format",
"description": "Date as described in ISO 8601 format",
"format": "date-time",
"type": "string",
"example": "2022-08-02T00:00:00.000Z"
},
"IdentifierUuidV4": {
"title": "UUID V4 identifier",
"description": "UUID V4 identifier",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"type": "string",
"example": "dc5b0048-2a80-4a22-b2f9-fad7d72f074d"
},
"BankAccountV1": {
"title": "Bank Account",
"description": "Description of a bank account",
"type": "object",
"required": [
"data"
],
"properties": {
"data": {
"$ref": "#/components/schemas/BankAccountV1Data"
}
}
},
"BankAccountV1CreationRequestData": {
"title": "Bank Account Creation Request Data",
"description": "Bank Account Creation Request Data",
"type": "object",
"required": [
"type",
"attributes"
],
"properties": {
"type": {
"type": "string",
"enum": [
"bank_accounts"
],
"example": "bank_accounts"
},
"attributes": {
"$ref": "#/components/schemas/BankAccountV1CreationRequestDataAttributes"
}
}
},
"BankAccountV1CreationRequest": {
"title": "Bank Account Creation Request",
"description": "Description of a bank account Creation Request",
"type": "object",
"required": [
"data"
],
"properties": {
"data": {
"$ref": "#/components/schemas/BankAccountV1CreationRequestData"
}
}
},
"BankAccountV1CreationRequestDataAttributes": {
"title": "Bank Account Creation Request Data Attributes",
"description": "Bank Account Creation Request Data Attributes",
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string",
"enum": [
"virtual_account"
],
"example": "virtual_account"
}
}
},
"BankAccountV1DataAttributes": {
"title": "Bank Account Data Attributes",
"description": "Bank Account Data Attributes",
"allOf": [
{
"$ref": "#/components/schemas/BankAccountV1CreationRequestDataAttributes"
},
{
"type": "object",
"required": [
"iban",
"swift_bic",
"created_at"
],
"properties": {
"iban": {
"$ref": "#/components/schemas/BankIban"
},
"swift_bic": {
"$ref": "#/components/schemas/Bic"
},
"created_at": {
"$ref": "#/components/schemas/DateIso8601"
}
}
}
]
},
"BankAccountV1Data": {
"title": "Bank Account Data",
"description": "Bank Account Data",
"type": "object",
"required": [
"id",
"type",
"attributes"
],
"properties": {
"id": {
"$ref": "#/components/schemas/IdentifierUuidV4"
},
"type": {
"type": "string",
"enum": [
"bank_accounts"
],
"example": "bank_accounts"
},
"attributes": {
"$ref": "#/components/schemas/BankAccountV1DataAttributes"
}
}
}
},
"securitySchemes": {
"OAuth2Customers": {
"type": "oauth2",
"description": "OAuth2 flow for server to server purposes (customers scope)",
"x-default": "",
"flows": {
"clientCredentials": {
"tokenUrl": "https://api.fintecture.com/oauth/accesstoken",
"scopes": {
"customers": "Grants access to customers"
}
}
}
}
}
},
"tags": [
{
"name": "customers",
"description": "Customers related endpoints",
"x-displayName": "Customers"
}
]
}
```