Skip to content
Nappai Documentation

ActiveCampaign Accounts Component

This component helps you manage your business or organization accounts inside ActiveCampaign. Whether you need to create new accounts, find existing ones, update their details, or remove them when they are no longer needed, this tool handles everything securely. It connects directly to your ActiveCampaign account, so your data stays perfectly synced without you having to manually switch between apps.

How it Works

Think of this component as a helpful assistant that talks to ActiveCampaign on your behalf. When you set it up, you simply provide the details for the accounts you want to manage. The component then securely communicates with ActiveCampaign’s servers behind the scenes, checks that your information is correct, sends the requests, and brings back a clear summary of what happened. You don’t need to worry about complex connections or code; you just fill in the fields, run your workflow, and receive a straightforward result.

Connection & Credentials

This component requires configuring a credential in the Nappai panel before interacting with the external service:

  1. Go to the Credentials section in your Nappai panel.
  2. Create a new credential of the type specified for this component and fill in the required fields (API Keys, tokens, etc.).
  3. In your workflow, select the saved credential in the Credential input field of this node.

You can get your credentials in your ActiveCampaign account by going to the Settings > Developer menu. The credential requires an API URL and an API Key.

Inputs

Input Fields

The following fields are available to configure this component:

  • Operation: Select the operation to perform
  • Get By: Retrieve a single account by ID or all accounts
  • Account ID: ID of the account
  • Account Name: Name of the account (company/organization)
  • Account URL: Website URL of the account
  • Limit: Maximum number of accounts to return
  • Contact ID: ID of the contact to associate with the account

Outputs

Output Data Example (JSON)json

{ “Data”: { “id”: “acc_98765”, “name”: “Global Solutions Ltd.”, “url”: “https://globalsolutions.com”, “status”: “active”, “custom_fields”: {}, “contacts”: [ { “id”: “cnt_54321”, “name”: “Alex Morgan” } ] }, “success”: true, “message”: “Account details retrieved successfully”, “error_code”: null, “records_deleted”: 0 } The component returns a clear summary of what happened. The Data field contains all the account details you requested, success confirms whether the action worked, message explains the result in plain text, error_code helps if something went wrong, and records_deleted shows how many accounts were removed (if applicable). You can easily connect these outputs to other components in your workflow to keep your automation flowing smoothly.

Usage Example

Scenario: You want to create a new business account in ActiveCampaign and link it to a specific contact.

  1. Set the Operation field to indicate you are adding a new account.
  2. Enter the Account Name (e.g., “Innovate Tech”) and the Account URL.
  3. If applicable, provide the Contact ID to link the account to a known person in your CRM.
  4. Run the workflow. The component will check your ActiveCampaign credentials, create the account, and return a success message along with the new account details. You can then pass these details to other components in Nappai for further automation, like triggering follow-up emails or updating marketing lists.

Tips and Best Practices

  • Always double-check the Account Name and Account URL before running the workflow to avoid creating duplicate records.
  • Use the Limit field when pulling lists of accounts to keep your dashboard fast and responsive.
  • If a workflow fails, look at the message or error_code output to quickly understand what needs to be fixed.
  • Keep your credential configuration up to date. If ActiveCampaign changes your API keys, update them in the Nappai panel to avoid connection interruptions.

Security Considerations

  • Your ActiveCampaign API credentials are stored securely within Nappai. Never share, copy, or expose them in public workflows or documentation.
  • The component only shares the exact data you configure, keeping your other ActiveCampaign information private and safe.
  • Regularly update or rotate your API keys if ActiveCampaign notifies you of security updates to keep your automated workflows protected.