Action Assemblies

All Action assemblies begin with an Action module that defines input data fields for the action to process:

Static input data fields can be typed into the module and configured manually. Generally this is only done when the action has a relatively small number of input fields.

Dynamic data fields can be loaded from a nested subassembly.

As an example of when dynamic fields must be loaded, consider a spreadsheet action to write a new row. The action doesn't know which columns are available until the sheet is inspected via the API and its columns are determined.

The outputs from the Action module are then typically formatted for sending to the API. The JSON Builder and XML Builder modules can be helpful for formatting simple API payloads. Complicated JSON/XML formatting usually requires custom coding via the Extension – Server-Side Script module.

Once data is formatted in the manner needed, the API is invoked via the HTTP or OAuth Transaction modules, or one of their variants.

After invoking an API call, the action should check for any error conditions and raise a fatal error if the API call was unsuccessful:

Some actions need to indicate to the system that the trigger data row should be skipped rather than retried. For example, an action that checks for existing duplicate data needs to skip the trigger data row if a duplicate exists. The Action - Skip Data Row module can be used within a Conditional module for this.

Actions can emit output data fields via the Action Output module:

The output data fields can be used as inputs to subsequent actions within automations.

Similar to the Action module, output fields can either be statically typed into the module or they can be determined dynamically.

For dynamic output fields, the Action - Extract Output Data Fields module can be used to automatically parse output fields from a data stream (typically the API's response):

For actions that only emit dynamic output fields, in most cases you will want to define default output fields in case the action logic is unable to fetch an API record at the time the action is configured in the automation editor. Review the help info about default output by mousing over the default output field in the module:

Actions can have have a defined throttle to enforce API rate limits. An action's thottle is defined when it is saved:

Action throttles are enforced at the scope of the account. So if a single user account has multiple automations that all use the same action, the throttle is applied across all of those automations.