Acumatica API - Endpoint Default 25 200 001Install

Summary

Insert or update a Business Account record in Acumatica using detailed parameters to specify the account's data and related nested information.

Inputs

• BusinessAccount — Specify the unique identifier or key data to identify or create the Business Account to be inserted or updated.
• MainAddress — Provide detailed main address information, including lines, city, state, postal code, country, and related address metadata.
• MainContact — Provide main contact details such as name, email, phone numbers, job title, and related nested details like activities and attributes.
• ShippingAddress — Supply shipping address details similar to the main address structure.
• ShippingContact — Provide shipping contact information including attention, email, phone numbers, job title, with an option to override main contact info.
• Attributes — Include one or multiple attribute objects defining attribute ID, description, value, activation, and requirement status.
• Campaigns — List one or more campaigns linked to the Business Account with campaign and contact identifiers plus stage data.
• Cases — Define related cases, each including identifiers, status, dates, owner, reason, severity, and other case-specific details.
• Contacts — Provide one or multiple contact records with details including city, email, phone numbers, job title, activity status, and owner.
• Contracts — Supply contracts related to the Business Account with contract ID, description, expiration, location, and status.
• DefaultLocationSettings — Set default location-based settings for the account, such as FOB point, insurance, lead times, price class, shipping rules, tax IDs, and warehouse data.
• Duplicates — Define duplicate identifiers and metadata detected for the Business Account record.
• Locations — Include various locations for the Business Account, each with address, sales account info, tax zone, and price class.
• MarketingLists — Add marketing list memberships with contact IDs, list names, subscription status, and dynamic list flags.
• Opportunities — Detail sales opportunities linked to the account including currency, stage, status, probability, total amounts, and owners.
• Orders — Specify customer orders under the account with details like order numbers, descriptions, quantities, totals, currency, and status.
• PrimaryContact — Provide data on the primary contact, including nested activities, addresses, attributes, campaigns, and related metadata.
• Relations — Describe one or multiple relationships the Business Account has to other accounts or contacts, with roles and document references.
• AdditionalFields — Set other optional fields such as account reference, class IDs, modification times, synchronization flags, and user information including roles and credentials.

Output shape

a single Business Account record object as returned by the Acumatica API after creation or update

The returned data includes the full updated Business Account information, reflecting the changes made or the created record. Fields omitted or left empty in input are not sent to Acumatica, and empty values are stripped from the payload automatically to avoid errors.

Examples

Example 1: Create a new Business Account with main contact and address

Provide key identifiers and name under BusinessAccount parameter; supply main contact details including email and phone; specify full main address; leave other optional nested collections empty.

Example 2: Update an existing Business Account's campaign and contact lists

Specify existing BusinessAccount identifier; populate Campaigns and Contacts fixed collections with updated entries to link or modify associated records.

Links

• n8n community nodes installation guide