---
updatedAt: 2025-11-12T21:46:51.000Z
agentTools:
  projectIndex: https://docs.getbeam.cash/llms.txt
---

# Create Virtual Account

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "enterprise-api",
    "version": "3.0"
  },
  "servers": [
    {
      "url": "https://api.getbeam.cash"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "apiKey",
        "name": "Authorization",
        "in": "header",
        "x-bearer-format": "bearer"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/smb/virtualAccounts": {
      "post": {
        "summary": "Create Virtual Account",
        "description": "",
        "operationId": "create-virtual-account",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "name"
                ],
                "properties": {
                  "accountId": {
                    "type": "string",
                    "description": "Person or Business id"
                  },
                  "name": {
                    "type": "string"
                  }
                }
              },
              "examples": {
                "Request Example": {
                  "value": {
                    "accountId": "4239f1be-f6fd-4adb-ab47-e39b43101042",
                    "name": "Virtual Account"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n    \"virtualAccount\": {\n        \"id\": \"15bdb81e-cac2-4ddc-aad2-7c3742efd176\",\n        \"name\": \"Virtual Account\",\n        \"parentAccountId\": \"4239f1be-f6fd-4adb-ab47-e39b43101042\"\n    },\n    \"fiatWallet\": {\n        \"id\": \"d57ca001-3fe9-4e49-873a-5838403328fc\",\n        \"asset\": \"usd\",\n        \"instructions\": {\n            \"wire\": {\n                \"refCode\": \"FT7P38337711\",\n                \"swiftCode\": \"PORGUS62XXX\",\n                \"receiverName\": \"John Doe\",\n                \"accountNumber\": \"404045710326\",\n                \"routingNumber\": \"021000021\",\n                \"receiverAddress\": {\n                    \"city\": \"Phoenix\",\n                    \"state\": \"AZ\",\n                    \"country\": \"US\",\n                    \"street1\": \"1234 Street\",\n                    \"postalCode\": \"85001\"\n                },\n                \"receiverBankName\": \"Portage Bank\",\n                \"receiverBankAddress\": {\n                    \"city\": \"Greenville\",\n                    \"state\": \"SC\",\n                    \"country\": \"US\",\n                    \"street1\": \"154 Deer Haven Drive\",\n                    \"street2\": \"\",\n                    \"postalCode\": \"29611\"\n                }\n            },\n            \"subAccountsWire\": []\n        }\n    }\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "virtualAccount": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "example": "15bdb81e-cac2-4ddc-aad2-7c3742efd176"
                        },
                        "name": {
                          "type": "string",
                          "example": "Virtual Account"
                        },
                        "parentAccountId": {
                          "type": "string",
                          "example": "4239f1be-f6fd-4adb-ab47-e39b43101042"
                        }
                      }
                    },
                    "fiatWallet": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "example": "d57ca001-3fe9-4e49-873a-5838403328fc"
                        },
                        "asset": {
                          "type": "string",
                          "example": "usd"
                        },
                        "instructions": {
                          "type": "object",
                          "properties": {
                            "wire": {
                              "type": "object",
                              "properties": {
                                "refCode": {
                                  "type": "string",
                                  "example": "FT7P38337711"
                                },
                                "swiftCode": {
                                  "type": "string",
                                  "example": "PORGUS62XXX"
                                },
                                "receiverName": {
                                  "type": "string",
                                  "example": "John Doe"
                                },
                                "accountNumber": {
                                  "type": "string",
                                  "example": "404045710326"
                                },
                                "routingNumber": {
                                  "type": "string",
                                  "example": "021000021"
                                },
                                "receiverAddress": {
                                  "type": "object",
                                  "properties": {
                                    "city": {
                                      "type": "string",
                                      "example": "Phoenix"
                                    },
                                    "state": {
                                      "type": "string",
                                      "example": "AZ"
                                    },
                                    "country": {
                                      "type": "string",
                                      "example": "US"
                                    },
                                    "street1": {
                                      "type": "string",
                                      "example": "1234 Street"
                                    },
                                    "postalCode": {
                                      "type": "string",
                                      "example": "85001"
                                    }
                                  }
                                },
                                "receiverBankName": {
                                  "type": "string",
                                  "example": "Portage Bank"
                                },
                                "receiverBankAddress": {
                                  "type": "object",
                                  "properties": {
                                    "city": {
                                      "type": "string",
                                      "example": "Greenville"
                                    },
                                    "state": {
                                      "type": "string",
                                      "example": "SC"
                                    },
                                    "country": {
                                      "type": "string",
                                      "example": "US"
                                    },
                                    "street1": {
                                      "type": "string",
                                      "example": "154 Deer Haven Drive"
                                    },
                                    "street2": {
                                      "type": "string",
                                      "example": ""
                                    },
                                    "postalCode": {
                                      "type": "string",
                                      "example": "29611"
                                    }
                                  }
                                }
                              }
                            },
                            "subAccountsWire": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {}
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```