---
updatedAt: 2026-10-13T13:39:17.000Z
---

# Update a Vendor Bank Account

**Supported for:**

`xero` `sageIntacct` `myob`

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "paths": {
    "/v2/accounting/vendors/bankAccounts/{id}": {
      "put": {
        "operationId": "put-vendors-bankAccounts",
        "summary": "Update a Vendor Bank Account",
        "description": "**Supported for:**\n\n`xero` `sageIntacct` `myob`",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PutVendorBankAccountDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PutVendorBankAccountResponseDto"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request Error - Thrown if fields sent via query does not follow specifications",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error400ResponseDtoV2"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized - Not logged in or log in expired",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error401ResponseDto"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden - Not enough permission",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error403ResponseDto"
                }
              }
            }
          },
          "500": {
            "description": "Server Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error500ResponseDto"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearer": []
          }
        ],
        "tags": [
          "Vendors"
        ]
      }
    }
  },
  "info": {
    "title": "FIS® Accounting Data as a Service™ API",
    "description": "[What's changed in our API](https://docs.railz.ai/changelog)",
    "version": "v2",
    "contact": {}
  },
  "servers": [
    {
      "url": "https://api.railz.ai",
      "description": "Main (production) API server"
    }
  ],
  "components": {
    "securitySchemes": {
      "bearer": {
        "scheme": "bearer",
        "bearerFormat": "JWT",
        "type": "http"
      }
    },
    "schemas": {
      "Error401Dto": {
        "type": "object",
        "properties": {
          "statusCode": {
            "type": "number",
            "readOnly": true,
            "example": 401
          },
          "message": {
            "readOnly": true,
            "example": [
              "Unauthorized"
            ],
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "error": {
            "type": "string",
            "readOnly": true,
            "example": "Unauthorized"
          }
        },
        "required": [
          "statusCode",
          "message",
          "error"
        ]
      },
      "Error401ResponseDto": {
        "type": "object",
        "properties": {
          "error": {
            "readOnly": true,
            "allOf": [
              {
                "$ref": "#/components/schemas/Error401Dto"
              }
            ]
          },
          "payload": {
            "type": "object",
            "readOnly": true,
            "example": {}
          }
        },
        "required": [
          "error",
          "payload"
        ]
      },
      "Error403Dto": {
        "type": "object",
        "properties": {
          "statusCode": {
            "type": "number",
            "readOnly": true,
            "example": 403
          },
          "message": {
            "readOnly": true,
            "example": [
              "Forbidden resource"
            ],
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "error": {
            "type": "string",
            "readOnly": true,
            "example": "Forbidden"
          }
        },
        "required": [
          "statusCode",
          "message",
          "error"
        ]
      },
      "Error403ResponseDto": {
        "type": "object",
        "properties": {
          "error": {
            "readOnly": true,
            "allOf": [
              {
                "$ref": "#/components/schemas/Error403Dto"
              }
            ]
          },
          "payload": {
            "type": "object",
            "readOnly": true,
            "example": {}
          }
        },
        "required": [
          "error",
          "payload"
        ]
      },
      "Error500Dto": {
        "type": "object",
        "properties": {
          "error": {
            "type": "string",
            "readOnly": true,
            "example": "Internal Server Error"
          },
          "message": {
            "readOnly": true,
            "example": [
              "INTERNAL_ERROR"
            ],
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "statusCode": {
            "type": "number",
            "readOnly": true,
            "example": 500
          }
        },
        "required": [
          "error",
          "message",
          "statusCode"
        ]
      },
      "Error500ResponseDto": {
        "type": "object",
        "properties": {
          "error": {
            "readOnly": true,
            "allOf": [
              {
                "$ref": "#/components/schemas/Error500Dto"
              }
            ]
          },
          "payload": {
            "type": "object",
            "readOnly": true
          }
        },
        "required": [
          "error",
          "payload"
        ]
      },
      "Error400DtoV2": {
        "type": "object",
        "properties": {
          "statusCode": {
            "type": "number",
            "readOnly": true,
            "example": 400
          },
          "message": {
            "readOnly": true,
            "example": [
              "connectionUuid should not be empty"
            ],
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "error": {
            "type": "string",
            "readOnly": true,
            "example": "Bad Request"
          }
        },
        "required": [
          "statusCode",
          "message",
          "error"
        ]
      },
      "Error400ResponseDtoV2": {
        "type": "object",
        "properties": {
          "error": {
            "readOnly": true,
            "allOf": [
              {
                "$ref": "#/components/schemas/Error400DtoV2"
              }
            ]
          },
          "payload": {
            "type": "object",
            "readOnly": true
          }
        },
        "required": [
          "error",
          "payload"
        ]
      },
      "VendorRefDto": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "example": "130"
          }
        },
        "required": [
          "id"
        ]
      },
      "PushBaseAddress": {
        "type": "object",
        "properties": {
          "line1": {
            "type": "string",
            "example": "1234 Park Street"
          },
          "line2": {
            "type": "string",
            "example": "Suite 1000"
          },
          "city": {
            "type": "string",
            "example": "Toronto"
          },
          "region": {
            "type": "string",
            "example": "ON"
          },
          "country": {
            "type": "string",
            "example": "CAN"
          },
          "postalCode": {
            "type": "string",
            "example": "A0B1C2"
          }
        }
      },
      "PutVendorBankAccount": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "example": "Business Bank Account"
          },
          "type": {
            "type": "string",
            "example": "checking"
          },
          "accountNumber": {
            "type": "string",
            "example": "11200"
          },
          "routingNumber": {
            "type": "string",
            "example": "123456789"
          },
          "bankName": {
            "type": "string",
            "example": "TD Bank"
          },
          "supportsAch": {
            "type": "boolean",
            "example": true
          },
          "supportsWire": {
            "type": "boolean",
            "example": true
          },
          "supportsCheck": {
            "type": "boolean",
            "example": true
          },
          "address": {
            "$ref": "#/components/schemas/PushBaseAddress"
          },
          "contactName": {
            "type": "string",
            "maxLength": 500,
            "example": "Jane Smith"
          },
          "currency": {
            "type": "string",
            "example": "CAD"
          },
          "vendorRef": {
            "$ref": "#/components/schemas/VendorRefDto"
          }
        }
      },
      "PutVendorBankAccountDto": {
        "type": "object",
        "properties": {
          "connectionUuid": {
            "type": "string",
            "description": "Unique connection identifier.",
            "example": "CON-396d5daa-26b2-4979-89b6-cafb2c298155"
          },
          "data": {
            "$ref": "#/components/schemas/PutVendorBankAccount"
          }
        },
        "required": [
          "connectionUuid",
          "data"
        ]
      },
      "PutVendorBankAccountResponseDto": {
        "type": "object",
        "properties": {
          "connectionUuid": {
            "type": "string",
            "readOnly": true,
            "example": "CON-396d5daa-26b2-4979-89b6-cafb2c298155"
          },
          "businessName": {
            "type": "string",
            "readOnly": true,
            "example": "Railz"
          },
          "serviceName": {
            "type": "string",
            "readOnly": true,
            "example": "xero",
            "enum": [
              "freshbooks",
              "quickbooks",
              "quickbooksDesktop",
              "xero",
              "oracleNetsuite",
              "sageBusinessCloud",
              "sageIntacct",
              "dynamicsBusinessCentral",
              "dynamics365Finance",
              "wave",
              "myob",
              "zohoBooks",
              "byod"
            ]
          },
          "pushCommunicationId": {
            "type": "string",
            "readOnly": true,
            "example": "60473b57f0cdd1683ca71f60"
          },
          "requestedOn": {
            "type": "string",
            "readOnly": true,
            "example": "2021-03-09T08:15:22.035Z",
            "format": "date-time"
          },
          "status": {
            "type": "string",
            "readOnly": true,
            "example": "pending",
            "enum": [
              "success",
              "failed",
              "pending"
            ]
          },
          "data": {
            "readOnly": true,
            "allOf": [
              {
                "$ref": "#/components/schemas/PutVendorBankAccount"
              }
            ]
          }
        },
        "required": [
          "connectionUuid",
          "businessName",
          "serviceName",
          "pushCommunicationId",
          "requestedOn",
          "status",
          "data"
        ]
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  }
}
```