> This page is for version v6.0 (default). > For other versions, use one of these documentation indexes: > - v6.0 (default): https://docs.zip.tax/v-6-0/llms.txt > - v5.0: https://docs.zip.tax/v-5-0/llms.txt > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.zip.tax/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.zip.tax/_mcp/server. # Update Nexus Location POST https://api.zip-tax.com/merchant/nexus/update Content-Type: application/json Available on Pro and Enterprise PlansReplaces a recorded location.The `location` block is a full replacement, not a patch: every field in it is written, so send the current value for anything you do not want cleared. The address is geocoded again, so an update may change the normalized address even when you send the same string, and a location can be moved to a different state this way.Available to self-managed merchants only; a TaxCloud-connected merchant returns 403. Reference: https://docs.zip.tax/api-reference/merchant-nexus/update ## Authentication - `X-API-KEY` header (required) — API Key authentication via header ## Request ### Body (application/json) This endpoint expects an object. - `location` (NexusLocationInput, required) — The location's new contents. Every field is replaced, so send the current value for anything you do not want to clear. - `locationId` (string, required) — Identifier of the location to replace, as returned by /merchant/nexus/create or /merchant/nexus/list. A location that has been deleted returns 404. - `merchantId` (string, required) — UUID of the merchant that owns the location. Must be owned by the calling account and must be self-managed. ## Response ### 200 OK - `location` (NexusLocationOutput, required) — The stored location after the update, with its normalized address. - `merchantId` (string, required) — UUID of the merchant the location belongs to. ## Errors ### 400 Merchant Nexus Update Body Bad Request Error Bad Request - `detail` (string, optional) — A human-readable explanation specific to this occurrence of the problem. - `errors` (list of ErrorDetail, optional) — List of individual error details - `instance` (string, optional) — A URI reference that identifies the specific occurrence of the problem. - `status` (long, optional) — HTTP status code - `title` (string, optional) — A short, human-readable summary of the problem type. This value should not change between occurrences of the error. - `type` (string, optional, default: about:blank) — A URI reference to human-readable documentation for the error. ### 401 Merchant Nexus Update Body Unauthorized Error Unauthorized - `detail` (string, optional) — A human-readable explanation specific to this occurrence of the problem. - `errors` (list of ErrorDetail, optional) — List of individual error details - `instance` (string, optional) — A URI reference that identifies the specific occurrence of the problem. - `status` (long, optional) — HTTP status code - `title` (string, optional) — A short, human-readable summary of the problem type. This value should not change between occurrences of the error. - `type` (string, optional, default: about:blank) — A URI reference to human-readable documentation for the error. ### 403 Merchant Nexus Update Body Forbidden Error Forbidden - `detail` (string, optional) — A human-readable explanation specific to this occurrence of the problem. - `errors` (list of ErrorDetail, optional) — List of individual error details - `instance` (string, optional) — A URI reference that identifies the specific occurrence of the problem. - `status` (long, optional) — HTTP status code - `title` (string, optional) — A short, human-readable summary of the problem type. This value should not change between occurrences of the error. - `type` (string, optional, default: about:blank) — A URI reference to human-readable documentation for the error. ### 404 Merchant Nexus Update Body Not Found Error Not Found - `detail` (string, optional) — A human-readable explanation specific to this occurrence of the problem. - `errors` (list of ErrorDetail, optional) — List of individual error details - `instance` (string, optional) — A URI reference that identifies the specific occurrence of the problem. - `status` (long, optional) — HTTP status code - `title` (string, optional) — A short, human-readable summary of the problem type. This value should not change between occurrences of the error. - `type` (string, optional, default: about:blank) — A URI reference to human-readable documentation for the error. ### 422 Merchant Nexus Update Body Unprocessable Entity Error Unprocessable Entity - `detail` (string, optional) — A human-readable explanation specific to this occurrence of the problem. - `errors` (list of ErrorDetail, optional) — List of individual error details - `instance` (string, optional) — A URI reference that identifies the specific occurrence of the problem. - `status` (long, optional) — HTTP status code - `title` (string, optional) — A short, human-readable summary of the problem type. This value should not change between occurrences of the error. - `type` (string, optional, default: about:blank) — A URI reference to human-readable documentation for the error. ### 429 Merchant Nexus Update Body Too Many Requests Error Too Many Requests - `detail` (string, optional) — A human-readable explanation specific to this occurrence of the problem. - `errors` (list of ErrorDetail, optional) — List of individual error details - `instance` (string, optional) — A URI reference that identifies the specific occurrence of the problem. - `status` (long, optional) — HTTP status code - `title` (string, optional) — A short, human-readable summary of the problem type. This value should not change between occurrences of the error. - `type` (string, optional, default: about:blank) — A URI reference to human-readable documentation for the error. ### 500 Merchant Nexus Update Body Internal Server Error Internal Server Error - `detail` (string, optional) — A human-readable explanation specific to this occurrence of the problem. - `errors` (list of ErrorDetail, optional) — List of individual error details - `instance` (string, optional) — A URI reference that identifies the specific occurrence of the problem. - `status` (long, optional) — HTTP status code - `title` (string, optional) — A short, human-readable summary of the problem type. This value should not change between occurrences of the error. - `type` (string, optional, default: about:blank) — A URI reference to human-readable documentation for the error. ### 503 Merchant Nexus Update Body Service Unavailable Error Service Unavailable - `detail` (string, optional) — A human-readable explanation specific to this occurrence of the problem. - `errors` (list of ErrorDetail, optional) — List of individual error details - `instance` (string, optional) — A URI reference that identifies the specific occurrence of the problem. - `status` (long, optional) — HTTP status code - `title` (string, optional) — A short, human-readable summary of the problem type. This value should not change between occurrences of the error. - `type` (string, optional, default: about:blank) — A URI reference to human-readable documentation for the error. ## Types ### NexusLocationInput - `address` (string, required) — The location's street address as a single line. It is geocoded when you send it, and the normalized result is what every response returns, so the value you get back will usually differ from the one you sent. US addresses only. An address that cannot be resolved to a state is rejected with 422 rather than stored. - `locationType` (enum, required) — What kind of presence this location represents. 'office', 'store', and 'warehouse' are premises you occupy; 'inventory_fba' covers inventory held in a third-party fulfilment network; 'employee' covers staff or contractors working in a state; 'property' covers inventory or equipment held there; 'temporary' covers short-term presence such as a trade show. - Allowed values: `office`, `store`, `warehouse`, `inventory_fba`, `employee`, `property`, `temporary` - `isFulfillmentOrigin` (boolean, optional) — Whether goods actually ship from this location. This is the field origin-sourcing consults, so set it explicitly for anything unusual, such as an office that also ships or a warehouse that does not. When omitted it defaults by locationType: true for 'warehouse', 'inventory_fba', and 'store'; false for the rest. - `name` (string, optional) — Your own label for this location. Shown back to you on every response and never used in a calculation. - `referenceId` (string, optional) — The ID you use in your own system to identify this location. - `registered` (boolean, optional) — Whether the merchant is registered to collect sales tax in this location's state. Defaults to false when omitted. ### NexusLocationOutput - `address` (string, required) — The normalized address resolved when the location was written, not the string you sent. - `isFulfillmentOrigin` (boolean, required) — Whether goods ship from this location. - `locationId` (string, required) — Server-issued identifier for this location. Use it with /merchant/nexus/update and /merchant/nexus/delete. - `locationType` (enum, required) — What kind of presence this location represents. - Allowed values: `office`, `store`, `warehouse`, `inventory_fba`, `employee`, `property`, `temporary` - `name` (string, required) — Your own label for this location. Empty when none was supplied. - `referenceId` (string, required) — The ID you use in your own system to identify this location. Empty when none was supplied. - `registered` (boolean, required) — Whether the merchant is registered to collect sales tax in this location's state. ### ErrorDetail - `location` (string, optional) — Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id' - `message` (string, optional) — Error message text - `value` (any, optional) — The value at the given location ## Examples **Request** ```json { "location": { "address": "1401 Lavaca St Austin TX 78701", "locationType": "office" }, "locationId": "6dc371de-00a4-44bf-8a88-2bcab2f15041", "merchantId": "merchantId" } ``` **Response** ```json { "location": { "address": "1401 Lavaca St, Austin, TX 78701-1634, United States", "isFulfillmentOrigin": true, "locationId": "6dc371de-00a4-44bf-8a88-2bcab2f15041", "locationType": "office", "name": "TestCo Texas Distribution Center", "referenceId": "warehouse-123", "registered": true }, "merchantId": "merchantId" } ``` **SDK Code** ```python import requests url = "https://api.zip-tax.com/merchant/nexus/update" payload = { "location": { "address": "1401 Lavaca St Austin TX 78701", "locationType": "office" }, "locationId": "6dc371de-00a4-44bf-8a88-2bcab2f15041", "merchantId": "merchantId" } headers = { "X-API-KEY": "", "Content-Type": "application/json" } response = requests.post(url, json=payload, headers=headers) print(response.json()) ``` ```javascript const url = 'https://api.zip-tax.com/merchant/nexus/update'; const options = { method: 'POST', headers: {'X-API-KEY': '', 'Content-Type': 'application/json'}, body: '{"location":{"address":"1401 Lavaca St Austin TX 78701","locationType":"office"},"locationId":"6dc371de-00a4-44bf-8a88-2bcab2f15041","merchantId":"merchantId"}' }; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.zip-tax.com/merchant/nexus/update" payload := strings.NewReader("{\n \"location\": {\n \"address\": \"1401 Lavaca St Austin TX 78701\",\n \"locationType\": \"office\"\n },\n \"locationId\": \"6dc371de-00a4-44bf-8a88-2bcab2f15041\",\n \"merchantId\": \"merchantId\"\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("X-API-KEY", "") 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 require 'uri' require 'net/http' url = URI("https://api.zip-tax.com/merchant/nexus/update") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Post.new(url) request["X-API-KEY"] = '' request["Content-Type"] = 'application/json' request.body = "{\n \"location\": {\n \"address\": \"1401 Lavaca St Austin TX 78701\",\n \"locationType\": \"office\"\n },\n \"locationId\": \"6dc371de-00a4-44bf-8a88-2bcab2f15041\",\n \"merchantId\": \"merchantId\"\n}" response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.post("https://api.zip-tax.com/merchant/nexus/update") .header("X-API-KEY", "") .header("Content-Type", "application/json") .body("{\n \"location\": {\n \"address\": \"1401 Lavaca St Austin TX 78701\",\n \"locationType\": \"office\"\n },\n \"locationId\": \"6dc371de-00a4-44bf-8a88-2bcab2f15041\",\n \"merchantId\": \"merchantId\"\n}") .asString(); ``` ```php request('POST', 'https://api.zip-tax.com/merchant/nexus/update', [ 'body' => '{ "location": { "address": "1401 Lavaca St Austin TX 78701", "locationType": "office" }, "locationId": "6dc371de-00a4-44bf-8a88-2bcab2f15041", "merchantId": "merchantId" }', 'headers' => [ 'Content-Type' => 'application/json', 'X-API-KEY' => '', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://api.zip-tax.com/merchant/nexus/update"); var request = new RestRequest(Method.POST); request.AddHeader("X-API-KEY", ""); request.AddHeader("Content-Type", "application/json"); request.AddParameter("application/json", "{\n \"location\": {\n \"address\": \"1401 Lavaca St Austin TX 78701\",\n \"locationType\": \"office\"\n },\n \"locationId\": \"6dc371de-00a4-44bf-8a88-2bcab2f15041\",\n \"merchantId\": \"merchantId\"\n}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = [ "X-API-KEY": "", "Content-Type": "application/json" ] let parameters = [ "location": [ "address": "1401 Lavaca St Austin TX 78701", "locationType": "office" ], "locationId": "6dc371de-00a4-44bf-8a88-2bcab2f15041", "merchantId": "merchantId" ] as [String : Any] let postData = JSONSerialization.data(withJSONObject: parameters, options: []) let request = NSMutableURLRequest(url: NSURL(string: "https://api.zip-tax.com/merchant/nexus/update")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "POST" 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() ```