ActiveCampaign

ActiveCampaign is a customer experience automation platform used to manage contacts, marketing automations, and behavioural events.

The ActiveCampaign Node exposes the provider's complete published v3 REST API dynamically and includes dedicated contact event-tracking methods. Use it when a Flowgear Workflow needs to manage ActiveCampaign data, configure tracking, feed customer activity to automations, or process tracked activity.

Revision History

0.1.0.0 - Flattened dynamic request and mutation response templates.

0.0.0.2 - Added dynamic templates for all published v3 REST operations.

0.0.0.1 - Initial release.

Connection

Use this Connection to store the account API credentials and event-submission credentials used by the Node methods.

Property Type Description
URL String Account-specific ActiveCampaign API URL without the /api/3 path, for example https://account.api-us1.com.
API Key Masked ActiveCampaign API key used for account API requests.
Event Account ID String The 9-digit account ID used to submit contact events.
Event Key Masked Event-tracking key used to submit contact events.
Timeout (seconds) Integer Timeout used for Connection validation and Node requests.

Setup Notes

  • Enter the account-specific API base URL in URL. It must be an absolute HTTPS URL without /api/3, a query, or a fragment.
  • Enter the account API token in API Key.
  • For Track Event, enter the 9-digit ID shown under WebsiteSite TrackingEvent Tracking API in Event Account ID. Enter the key shown under WebsiteSite TrackingEvent Tracking in Event Key.
  • Set Timeout (seconds) to a value greater than zero.
  • Click Test to validate the URL and API Key by retrieving the current ActiveCampaign user.
  • See the ActiveCampaign Contact Event Tracking API Guide for provider-side event-tracking setup.

Methods

The Node groups ActiveCampaign's dynamically discovered v3 REST operations by HTTP method and also exposes dedicated methods for contact event tracking.

Query

Executes any GET operation published in ActiveCampaign's current OpenAPI registry, including operations such as retrieving Address Lists and Branding.

Parameter Type Description
Connection Connection ActiveCampaign account API Connection.
OperationId String Internal operation identifier populated by the selected template.
Options Object Path and query parameters documented for the selected operation.
Items Array Request-body items when the selected GET operation documents a body. Omit this Parameter for ordinary GET operations.
Return Type Description
Response Array Provider-shaped response rows without a Flowgear object.

Create

Executes any POST operation published in ActiveCampaign's current OpenAPI registry, including Create an Account.

Parameter Type Description
Connection Connection ActiveCampaign account API Connection.
OperationId String Internal operation identifier populated by the selected template.
Options Object Path and query parameters documented for the selected operation.
Items Array JSON request-body items documented for the selected operation.
Return Type Description
Response Array One response per input item containing provider fields at the response root and normalized Flowgear mutation metadata.

Replace

Executes any PUT operation published in ActiveCampaign's current OpenAPI registry.

Parameter Type Description
Connection Connection ActiveCampaign account API Connection.
OperationId String Internal operation identifier populated by the selected template.
Options Object Path and query parameters documented for the selected operation.
Items Array JSON request-body items documented for the selected operation.
Return Type Description
Response Array One response per input item containing provider fields at the response root and normalized Flowgear mutation metadata.

Update

Executes any PATCH operation published in ActiveCampaign's current OpenAPI registry.

Parameter Type Description
Connection Connection ActiveCampaign account API Connection.
OperationId String Internal operation identifier populated by the selected template.
Options Object Path and query parameters documented for the selected operation.
Items Array JSON request-body items documented for the selected operation.
Return Type Description
Response Array One response per input item containing provider fields at the response root and normalized Flowgear mutation metadata.

Delete

Executes any DELETE operation published in ActiveCampaign's current OpenAPI registry, including bulk operations that document a request body.

Parameter Type Description
Connection Connection ActiveCampaign account API Connection.
OperationId String Internal operation identifier populated by the selected template.
Options Object Path and query parameters documented for the selected operation.
Items Array Request-body items when the selected DELETE operation documents a body.
Return Type Description
Response Array One response per input item containing provider fields at the response root and normalized Flowgear mutation metadata.

Get Event Tracking Status

Retrieves whether contact event tracking is enabled for the ActiveCampaign account.

Parameter Type Description
Connection Connection ActiveCampaign account API Connection.
Return Type Description
Status Object ActiveCampaign event-tracking status containing the enabled value.

Set Event Tracking Status

Enables or disables contact event tracking for the ActiveCampaign account.

Parameter Type Description
Connection Connection ActiveCampaign account API Connection.
Enabled Boolean Desired event-tracking state.
Return Type Description
Status Object Updated event-tracking status and a Flowgear object containing IsSuccess, Message, and the submitted Request.

List Event Names

Lists the event names available for ActiveCampaign automations.

Parameter Type Description
Connection Connection ActiveCampaign account API Connection.
Return Type Description
Events Array Event-name rows returned by ActiveCampaign. Each row contains name. The Node emits zero rows when no event names are returned.

Create Event Name

Creates one event name for use in ActiveCampaign automations.

Parameter Type Description
Connection Connection ActiveCampaign account API Connection.
EventName String Event name to create.
Return Type Description
Event Object ActiveCampaign response and a Flowgear object containing IsSuccess, Message, and the submitted Request.

Delete Event Name

Deletes one event name without deleting contact events already recorded with that name.

Parameter Type Description
Connection Connection ActiveCampaign account API Connection.
EventName String Exact event name to delete.
Return Type Description
Event Object ActiveCampaign response and a Flowgear object containing IsSuccess, Message, and the submitted Request.

Track Event

Records one event against an existing ActiveCampaign contact identified by email address.

Parameter Type Description
Connection Connection ActiveCampaign Connection containing the account API and event-submission credentials.
EventName String Event name to record. The value must not exceed 32 characters.
Email String Email address of an existing ActiveCampaign contact.
EventData String Optional string value to store with the event.
Return Type Description
Event Object ActiveCampaign event-submission response and a Flowgear object containing IsSuccess, Message, and the submitted Request.

Get Contact Events

Retrieves recorded events for one ActiveCampaign contact.

Parameter Type Description
Connection Connection ActiveCampaign account API Connection.
ContactId String ActiveCampaign contact ID.
Return Type Description
Events Array Contact event rows returned by ActiveCampaign, including id, contact, type, value, and tstamp. The Node emits zero rows when the contact has no events.

Usage Notes

  • Select the template for the method you want to use to populate its supported parameters and return shape.
  • Query, Create, Replace, Update, and Delete load the current operation list from ActiveCampaign's public OpenAPI registry and cache it for one hour. Connection credentials are not sent while loading these templates.
  • Dynamic REST templates group operations by HTTP method. For example, use Query for Retrieve an AddressList or Retrieve a Branding, and use Create for Create an Account.
  • Do not set OperationId manually. Select a template so the Node receives the exact operation identifier and documented Options and Items shape.
  • Dynamic templates omit a single top-level resource envelope from Items. For example, Create a Contact exposes the contact fields directly and restores the provider-required contact object when sending the request. Nested business objects remain unchanged.
  • Track Event and Delete Event Name load the event names configured in the connected ActiveCampaign account. Select an event-specific template to prepopulate EventName, or select Custom to supply the value at runtime.
  • Query, Get Event Tracking Status, List Event Names, and Get Contact Events return provider-shaped business data without a Flowgear object.
  • Provider failures from read methods stop the Node. The first provider request completes while the method is invoked, before downstream enumeration starts.
  • Mutation responses preserve provider fields and add Flowgear.IsSuccess, Flowgear.Message, and Flowgear.Request. Handled provider failures can also include the sanitized provider payload under ActiveCampaignError.
  • Delete Event Name removes the name from the list available to automations but preserves contact events already recorded with that name.
  • Event Account ID and Event Key are required only by Track Event.

Known Issues

  • ActiveCampaign does not expose the Event Key through its v3 API. Copy it from the account's event-tracking settings.
  • Track Event records events only for contacts that already exist in ActiveCampaign.
  • Loading dynamic REST templates requires outbound HTTPS access to ActiveCampaign's public OpenAPI registry. A failed refresh is not cached and can be retried.