Acumatica API - Custom Endpoint icon

Acumatica API - Custom Endpoint

Interact with a custom Acumatica endpoint (schema fetched from the instance)

Invoke Action

AI-generated

Summary

Invokes a named workflow action on the selected Acumatica entity with a request body containing mapped entity fields, optional custom fields, and action parameters. If Acumatica responds that the action is running asynchronously, the node polls the response URL and returns the final response body or a success status.

Inputs

  • Endpoint Name (required) — Acumatica endpoint name, such as Default or JMS.CRM.
  • Endpoint Version (required) — Endpoint version, such as 24.200.001 or 1.0.
  • Action Name — Workflow action to invoke; options are loaded for the selected resource.
  • Parameters — JSON object of action parameters; defaults to an empty object.
  • Fields — Entity fields to include with the action. Scalar fields are sent as Acumatica value wrappers when the schema marks them as wrapped; nested objects and arrays are passed through as JSON. Empty values are omitted.
  • Custom Fields — Optional custom fields, each identified by Acumatica view name and field name, with a type token and value. Values are converted to numbers or booleans when the type token indicates those types.

Output shape

One output item per input item, containing the action response as JSON.

The request uses POST to the selected entity/action path. A non-empty response body is returned directly; an empty body yields {"success":true,"statusCode":}. For a 202 response with a Location header, the node polls that URL once per second for up to 60 polls. Errors are thrown unless Continue On Fail is enabled, in which case an item with an error field is returned.

Links

Discussion