Actions478
- Account Actions
- Account Details For Period Inquiry Actions
- Account Group Actions
- Account Summary Inquiry Actions
- Activity Actions
- Amazon Store Actions
- Appointment Actions
- Attribute Definition Actions
- Big Commerce Stores Actions
- Bill Actions
- Budget Actions
- Business Account Actions
- Carrier Actions
- Case Actions
- Cash Sale Actions
- Cash Transaction Actions
- Change Order Actions
- Change Order Class Actions
- Check Actions
- Companies Structure Actions
- Company Financial Period Actions
- Contact Actions
- Contract Usage Actions
- Cost Code Actions
- Currency Actions
- Customer Actions
- Customer Class Actions
- Customer Location Actions
- Customer Payment Method Actions
- Customer Price Class Actions
- Deduction Benefit Code Actions
- Discount Actions
- Discount Code Actions
- Earning Type Code Actions
- Email Actions
- Email Processing Actions
- Employee Actions
- Employee Payroll Class Actions
- Employee Payroll Settings Actions
- Event Actions
- Expense Claim Actions
- Expense Receipt Actions
- External Commitment Actions
- Financial Period Actions
- Financial Year Actions
- F O B Point Actions
- Inventory Adjustment Actions
- Inventory Allocation Inquiry Actions
- Inventory Issue Actions
- Inventory Quantity Available Actions
- Inventory Receipt Actions
- Inventory Summary Inquiry Actions
- Invoice Actions
- Item Class Actions
- Item Sales Category Actions
- Item Warehouse Actions
- Journal Transaction Actions
- Kit Assembly Actions
- Kit Specification Actions
- Labor Cost Rate Actions
- Lead Actions
- Ledger Actions
- Lot Serial Class Actions
- Non Stock Item Actions
- Opportunity Actions
- Pay Group Actions
- Payment Actions
- Payment Method Actions
- Pay Period Actions
- Payroll Batch Actions
- Payroll Union Local Actions
- Payroll W C C Code Actions
- Physical Inventory Count Actions
- Physical Inventory Review Actions
- Pro Forma Invoice Actions
- Project Actions
- Project Budget Actions
- Project Task Actions
- Project Template Actions
- Project Template Task Actions
- Project Transaction Actions
- P T O Bank Actions
- Purchase Order Actions
- Purchase Receipt Actions
- Sales Invoice Actions
- Sales Order Actions
- Salesperson Actions
- Sales Prices Inquiry Actions
- Sales Price Worksheet Actions
- Service Order Actions
- Shipment Actions
- Shipping Box Actions
- Shipping Term Actions
- Shipping Zones Actions
- Ship Via Actions
- Shopify Store Actions
- Stock Item Actions
- Storage Details By Location Inquiry Actions
- Storage Details Inquiry Actions
- Subaccount Actions
- Subcontract Actions
- Task Actions
- Tax Actions
- Tax Category Actions
- Tax Reporting Settings Actions
- Tax Zone Actions
- Template Items Actions
- Time Entry Actions
- Transfer Order Actions
- Union Local Actions
- Units Of Measure Actions
- Vendor Actions
- Vendor Class Actions
- Vendor Prices Inquiry Actions
- Vendor Price Worksheet Actions
- Warehouse Actions
- Work Calendar Actions
- Work Class Compensation Code Actions
- Work Location Actions
Customer Location → Insert/Update
AI-generatedSummary
Insert or update a Customer Location record in Acumatica by specifying various details including address, contact information, attributes, and related entities. This operation sends the provided structured data to the Acumatica API to create a new customer location or update an existing one.
Inputs
- BusinessAccount (required) — The identifier of the business account associated with the customer location.
- LocationID — The unique identifier for the location; if provided, updates the existing location, otherwise inserts new.
- LocationName — The name of the customer location.
- Address — Nested record containing detailed address information including lines, city, state, country, postal code, and additional address-related fields.
- LocationContact — Contact information for the location including active status, multiple activities with details, status, summary, type, and related contact IDs.
- Attributes — Custom attributes associated with the location, including attribute ID, description, value, and flags for active and required status.
- RoleAssignments — Assignments of roles to contacts at the location with details such as role name, creation and modification dates.
- AdditionalFields — Additional optional fields such as active status, calendar, shipping parameters, tax information, and more as per Acumatica schema.
Output shape
a structured object representing the upserted Customer Location record as returned by the Acumatica API
The output includes all provided fields along with any generated or default values from Acumatica. The operation handles both inserting a new record if LocationID is not specified or updating an existing one if it is. Errors from the API will result in failure responses rather than successful output.
Examples
Example 1: Insert a new Customer Location
Provide a business account ID along with required address and contact details without specifying LocationID to create a new customer location.
Example 2: Update an existing Customer Location
Specify the LocationID with updated address, contact, or additional fields to modify an existing customer location record.