> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://api-docs.papertracc.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://api-docs.papertracc.com/_mcp/server. # Update Vendor Account PATCH https://api.papertracc.com/v1/profiles/vendors/{id}/accounts Content-Type: application/json Updates a vendor's bank or account details. Requires the `can_modify_vendor_profile` permission on the key owner's role. **Keys:** secret key only. Reference: https://api-docs.papertracc.com/core/profiles/vendors/update-vendor-account ## Authentication - `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer `, where token is your auth token. - `identity` header (required) — The identity for the active workspace. ## Servers - `https://api.papertracc.com/v1` (Production, default) - `https://api.papertracc.com/rc-1` (Release Candidate 1) ## Request ### Path parameters - `id` (string, required) ### Body (application/json) This endpoint expects an object. - `currency_code` (string, required) - `account_number` (string, required) ## Response ### 200 OK - `data` (ProfilesVendorsIdAccountsPatchResponsesContentApplicationJsonSchemaData, required) - `status` (boolean, required) - `message` (string, required) ## Errors ### 401 Unauthorized Error The API key is missing or invalid, the key owner is no longer an active member of the organisation, or the key owner is not a member of the workspace in the `identity` header. - `status` (boolean, required) - `message` (string, required) - `error_code` (enum, optional) — Machine-readable reason. Present on 402 and 403 responses. - Allowed values: `PERMISSION_DENIED`, `SERVICE_DISABLED`, `OPEN_API_NOT_ENABLED` - `permission` (string, optional) — The role permission the request needs. Set when `error_code` is `PERMISSION_DENIED`. - `service` (string, optional) — The workspace service that is turned off. Set when `error_code` is `SERVICE_DISABLED`. ### 402 Payment Required Error The workspace's subscription plan does not include the Open API. - `status` (boolean, required) - `message` (string, required) - `error_code` (enum, optional) — Machine-readable reason. Present on 402 and 403 responses. - Allowed values: `PERMISSION_DENIED`, `SERVICE_DISABLED`, `OPEN_API_NOT_ENABLED` - `permission` (string, optional) — The role permission the request needs. Set when `error_code` is `PERMISSION_DENIED`. - `service` (string, optional) — The workspace service that is turned off. Set when `error_code` is `SERVICE_DISABLED`. ### 403 Forbidden Error Either the key owner's role does not include the permission this endpoint needs (`PERMISSION_DENIED`), or the service this endpoint belongs to is turned off for the workspace (`SERVICE_DISABLED`). - `status` (boolean, required) - `message` (string, required) - `error_code` (enum, optional) — Machine-readable reason. Present on 402 and 403 responses. - Allowed values: `PERMISSION_DENIED`, `SERVICE_DISABLED`, `OPEN_API_NOT_ENABLED` - `permission` (string, optional) — The role permission the request needs. Set when `error_code` is `PERMISSION_DENIED`. - `service` (string, optional) — The workspace service that is turned off. Set when `error_code` is `SERVICE_DISABLED`. ## Types ### ProfilesVendorsIdAccountsPatchResponsesContentApplicationJsonSchemaData - `id` (string, required) - `type` (string, required) - `email` (string, required) - `phone` (string, required) - `accounts` (list of ProfilesVendorsIdAccountsPatchResponsesContentApplicationJsonSchemaDataAccountsItems, required) - `last_name` (string, required) - `contact_id` (string, required) - `created_at` (datetime, required) - `first_name` (string, required) - `project_id` (string, required) - `company_name` (string, required) - `display_name` (string, required) - `billing_address` (ProfilesVendorsIdAccountsPatchResponsesContentApplicationJsonSchemaDataBillingAddress, required) - `shipping_address` (ProfilesVendorsIdAccountsPatchResponsesContentApplicationJsonSchemaDataShippingAddress, required) - `payment_term_id` (string, optional, nullable) — The contact's default payment term, or null when none is set. ### ProfilesVendorsIdAccountsPatchResponsesContentApplicationJsonSchemaDataAccountsItems - `bank` (string, required) - `code` (string, required) - `vat_id` (string, required) - `is_default` (boolean, required) - `account_name` (string, required) - `currency_code` (string, required) - `account_number` (string, required) ### ProfilesVendorsIdAccountsPatchResponsesContentApplicationJsonSchemaDataBillingAddress - `city` (string, required) - `name` (string, required) - `phone` (string, required) - `state` (string, required) - `country` (string, required) - `post_code` (string, required) - `address_one` (string, required) - `country_code` (string, required) ### ProfilesVendorsIdAccountsPatchResponsesContentApplicationJsonSchemaDataShippingAddress - `city` (string, required) - `name` (string, required) - `phone` (string, required) - `state` (string, required) - `country` (string, required) - `post_code` (string, required) - `address_one` (string, required) - `country_code` (string, required) ## Examples **Request** ```json { "currency_code": "NGN", "account_number": "9876543210" } ``` **Response** ```json { "data": { "id": "0cb2d1a5-2f50-43a1-8c3f-df06f998ef51", "type": "BUSINESS", "email": "john@example.com", "phone": "+2348012345678", "accounts": [ { "bank": "Spruce Bank", "code": "044", "vat_id": "78c68f6d-d734-4822-9a6c-73f517a0e5c1", "is_default": true, "account_name": "John Doe", "currency_code": "NGN", "account_number": "1234567890" } ], "last_name": "Doe", "contact_id": "64595845-34ec-482c-b0fe-ae617a0f8335", "created_at": "2026-06-18T10:00:00Z", "first_name": "John", "project_id": "spruce-demo", "company_name": "Acme Corp", "display_name": "Global Softworks", "billing_address": { "city": "Lagos", "name": "Office", "phone": "+2348012345678", "state": "Lagos", "country": "Nigeria", "post_code": "100001", "address_one": "12 Marina Road", "country_code": "NG" }, "shipping_address": { "city": "Lagos", "name": "Office", "phone": "+2348012345678", "state": "Lagos", "country": "Nigeria", "post_code": "100001", "address_one": "12 Marina Road", "country_code": "NG" }, "payment_term_id": null }, "status": true, "message": "Successfully updated vendor account" } ``` **SDK Code** ```python Profiles_Vendors_Update Vendor Account_example import requests url = "https://api.papertracc.com/v1/profiles/vendors/id/accounts" payload = { "currency_code": "NGN", "account_number": "9876543210" } headers = { "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.patch(url, json=payload, headers=headers) print(response.json()) ``` ```javascript Profiles_Vendors_Update Vendor Account_example const url = 'https://api.papertracc.com/v1/profiles/vendors/id/accounts'; const options = { method: 'PATCH', headers: {Authorization: 'Bearer ', 'Content-Type': 'application/json'}, body: '{"currency_code":"NGN","account_number":"9876543210"}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go Profiles_Vendors_Update Vendor Account_example package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.papertracc.com/v1/profiles/vendors/id/accounts" payload := strings.NewReader("{\n \"currency_code\": \"NGN\",\n \"account_number\": \"9876543210\"\n}") req, _ := http.NewRequest("PATCH", url, payload) req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby Profiles_Vendors_Update Vendor Account_example require 'uri' require 'net/http' url = URI("https://api.papertracc.com/v1/profiles/vendors/id/accounts") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Patch.new(url) request["Authorization"] = 'Bearer ' request["Content-Type"] = 'application/json' request.body = "{\n \"currency_code\": \"NGN\",\n \"account_number\": \"9876543210\"\n}" response = http.request(request) puts response.read_body ``` ```java Profiles_Vendors_Update Vendor Account_example import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.patch("https://api.papertracc.com/v1/profiles/vendors/id/accounts") .header("Authorization", "Bearer ") .header("Content-Type", "application/json") .body("{\n \"currency_code\": \"NGN\",\n \"account_number\": \"9876543210\"\n}") .asString(); ``` ```php Profiles_Vendors_Update Vendor Account_example request('PATCH', 'https://api.papertracc.com/v1/profiles/vendors/id/accounts', [ 'body' => '{ "currency_code": "NGN", "account_number": "9876543210" }', 'headers' => [ 'Authorization' => 'Bearer ', 'Content-Type' => 'application/json', ], ]); echo $response->getBody(); ``` ```csharp Profiles_Vendors_Update Vendor Account_example using RestSharp; var client = new RestClient("https://api.papertracc.com/v1/profiles/vendors/id/accounts"); var request = new RestRequest(Method.PATCH); request.AddHeader("Authorization", "Bearer "); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"currency_code\": \"NGN\",\n \"account_number\": \"9876543210\"\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift Profiles_Vendors_Update Vendor Account_example import Foundation let headers = [ "Authorization": "Bearer ", "Content-Type": "application/json" ] let parameters = [ "currency_code": "NGN", "account_number": "9876543210" ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.papertracc.com/v1/profiles/vendors/id/accounts")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "PATCH" request.allHTTPHeaderFields = headers request.httpBody = postData as Data let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```