Active campaign

This package I hope will help to work with Active Campaign API v3.

Note

I created this package for my own use.
In my project, I used not all functionality which proposes Active Campaign.
So I do not know which result you can get. I tested all based on Active Campaign documentation
If you find some bugs, or you want to improve something to be free to create issues or merge requests.
I will try to be communicable.

List of features

| Versions of API | Implemented | QA | Tests | | -------------------------- | ----------- | ------- | ------- | | V3 | ✓ | ✗ | ✗ |

| Functionality | Implemented | QA | Tests | | -------------------------- | ----------- | ------- | ------- | | ACCOUNTS | ✓ | ✗ | ✗ | | ADDRESSES | ✓ | ✗ | ✗ | | AUTOMATIONS | ✓ | ✗ | ✗ | | BRANDING | ✓ | ✗ | ✗ | | CALENDAR FEEDS | ✓ | ✗ | ✗ | | CAMPAIGNS | ✓ | ✗ | ✗ | | CONTACTS | ✓ | ✓ | ✗ | | DEALS | ✓ | ✗ | ✗ | | DEEPDATA INTEGRATIONS | ✓ | ✗ | ✗ | | FORMS | ✓ | ✗ | ✗ | | LISTS | ✓ | ✗ | ✗ | | NOTES | ✓ | ✗ | ✗ | | ORGANIZATIONS (DEPRECATED) | ✓ | ✗ | ✗ | | SAVED RESPONSES | ✓ | ✗ | ✗ | | SCORES | ✓ | ✗ | ✗ | | SEGMENTS | ✓ | ✗ | ✗ | | SETTINGS | ✓ | ✗ | ✗ | | SITE & EVENT TRACKING | ✓ | ✗ | ✗ | | TAGS | ✓ | ✗ | ✗ | | TASKS | ✓ | ✗ | ✗ | | TASK TYPES | ✓ | ✗ | ✗ | | TEMPLATES | ✓ | ✗ | ✗ | | USERS | ✓ | ✗ | ✗ | | WEBHOOKS | ✓ | ✗ | ✗ |

✓ - it is implemented, and you can use these functions from a package.

✗ - functionality will add in close time.

Installing

Using npm:

npm install active-campaign

Using yarn:

yarn add active-campaign

Example

Configure client

const ActiveCampaign = require('active-campaign');

const ACTIVE_CAMPAIGN_API_URL = https://your-company-name.api-us1.com // it is example
const ACTIVE_CAMPAIGN_API_KEY = You can get this API_KEY from your active campaign account. Details https://developers.activecampaign.com/reference#authentication

const ac = new ActiveCampaign({
  apiUrl: ACTIVE_CAMPAIGN_API_URL,
  apiKey: ACTIVE_CAMPAIGN_API_KEY,
});

// This method return all contacts from your active compaign
const listAllContacts = await ac.contacts.contact.listAll();

console.log(listAllContacts)

// This method create a contact in your active compaign
const contact = await ac.contacts.contact.create({
	"contact": {
		"email": "[email protected]",
		"firstName": "John",
		"lastName": "Doe",
		"phone": "7223224241",
    "fieldValues":[
      {
        "field":"1",
        "value":"The Value for First Field"
      },
      {
        "field":"6",
        "value":"2008-01-20"
      }
    ]
	}
});

console.log(contact)

Full list of methods you can see in the section Available resources and methods

Available resources and methods

Use official Documentation for create an object.

• accounts

  • account

    • createAccount(object)
    • updateAccount(id, object)
    • retrieveAccount(id)
    • deleteAccount(id)
    • listAllAccounts(object)
    • createAccountNote(id, object)
    • updateAccountNote(id, object)
    • bulkDeleteAccounts(id, object)

  • accountContactAssociation

    • createAssociation(object)
    • retrieveAssociation(id)
    • updateAssociation(id, object)
    • deleteAssociation(id)
    • listAllAssociation(object)

  • customAccountField

    • createCustomField(object)
    • retrieveCustomField(id)
    • updateCustomField(id, object)
    • deleteCustomField(id)
    • listAllCustomField(object)

  • customAccountFieldsValue

    • createCustomFieldValue(object)
    • bulkCreateCustomFieldValue(object)
    • retrieveCustomFieldValue(id)
    • updateCustomFieldValue(id, object)
    • deleteCustomFieldValue(id)
    • listAllCustomFieldValue(object)
    • bulkUpdateCustomFieldValue(object)

• addresses

  • address
    • createAddress(object)
    • updateAddress(id, object)
    • retrieveAddress(id)
    • deleteAddress(id)
    • deleteAddressAssociatedWithSpecificUserGroup(id)
    • deleteAddressAssociatedWithSpecificList(id)
    • listAllAddresses(object)

• automations

  • automation
    • listAllAutomations(object)

• brandings

  • branding
    • retrieveBranding(id)
    • updateBranding(object)
    • listAllBrandings(object)

• calendarFeeds

  • calendarFeed
    • create(object)
    • retrieve(id)
    • update(id, object)
    • delete(id)
    • listAll(object)

• campaigns

  • campaign
  • listAll(object)
  • retrieveLinksAssociatedToCampaign(id)
  • retrieveCampaign(id)
  • message
  • create(object)
  • retrieve(id)
  • update(id, object)
  • delete(id)
  • listAll(object)

• contacts

  • contact

    • create(object)
    • createOrUpdate(object)
    • retrieve(id)
    • updateListStatus(object)
    • update(id, object)
    • delete(id)
    • listAll(object)
    • listAllAutomations(id)
    • retrieveContactsScoreValue(id)
    • bulkImport(object)

  • automation

    • addContactToAutomation(object)
    • retrieveAutomationContactIsIn(id)
    • removeContactFromAutomation(id)
    • listAllAutomationsContactIsIn(object)

  • customField

    • create(object)
    • retrieve(id)
    • update(id, object)
    • delete(id)
    • listAll(object)
    • createRelationshipToList(object)
    • createOptions(object)

  • customFieldsValue

    • createCustomFieldValue(object)
    • retrieveCustomFieldValue(id)
    • updateCustomFieldValueForContact(id, object)
    • deleteCustomFieldValue(id)
    • listAllCustomFieldValues(object)

• deals

  • deal

    • create(object)
    • retrieve(id)
    • update(id, object)
    • delete(id)
    • listAll(object)
    • CreateDealNote(id, object)
    • updateDealNote(id, object)

  • customDealField

    • create(object)
    • retrieve(id)
    • update(id, object)
    • delete(id)
    • listAll(object)

  • customDealFieldValue

    • create(object)
    • retrieve(id)
    • update(id, object)
    • delete(id)
    • listAll(object)
    • bulkCreateCustomFieldValue(object)
    • bulkUploadCustomFieldValue(object)

  • pipeline

    • create(object)
    • retrieve(id)
    • update(id, object)
    • delete(id)
    • listAll(object)

  • secondaryContract

    • create(object)
    • retrieve(id)
    • update(id, object)
    • delete(id)
    • listAll(object)

  • stage

    • create(object)
    • retrieve(id)
    • update(id, object)
    • delete(id)
    • listAll(object)
    • moveDealToAnotherStage(id, object)

• deepdataIntegrations

  • connection
    • create(object)
    • retrieve(id)
    • update(id, object)
    • delete(id)
    • listAll(object)
  • eCommerceCustomer
    • create(object)
    • retrieve(id)
    • update(id, object)
    • delete(id)
    • listAll(object)
  • eCommerceOrder
    • create(object)
    • retrieve(id)
    • update(id, object)
    • delete(id)
    • listAll(object)
  • eCommerceOrderProduct
    • listEcomOrderProducts(object)
    • listEcomOrderProductsForSpecificEcomOrder(id, object)
    • retrieveEcomOrderProduct(id, object)

• forms

  • form
    • retrieve(id)
    • listAll(object)

• lists

  • list
    • create(object)
    • retrieve(id)
    • delete(id)
    • listAll(object)
    • CreateListGroupPermission(object)

• notes

  • note
    • create(object)
    • retrieve(id)
    • update(id, object)
    • delete(id)

• organizations

  • organization
    • create(object)
    • retrieve(id)
    • update(id, object)
    • delete(id)
    • deleteMultipleOrganizations(object)
    • listAll(object)

• savedResponses

  • savedResponse
    • create(object)
    • retrieve(id)
    • update(id, object)
    • delete(id)
    • listAll(object)

• scores

  • score
    • retrieve(id)
    • listAll(object)

• segments

  • segments
    • retrieve(id)
    • listAll(object)

• settings

  • settings
    • update(id, object)

• siteEventTrecking

  • eventTracking

    • trackEvent(object)
    • create(object)
    • retrieveStatus(id)
    • update(object)
    • delete(name)
    • listAll(object)

  • siteTracking

    • addDomainToWhitelist(object)

    • retrieveCode()

    • retrieveStatus()

    • update(object)

    • removeDomainFromWhitelist(name)

    • listAll(object)

• tags

  • tags
    • create(object)
    • retrieve(id)
    • update(id, object)
    • delete(id)
    • listAll(object)

• tasks

  • task
    • create(object)
    • retrieve(id)
    • update(id, object)
    • delete(id)
    • listAll(object)

• taskTypes

  • taskType
    • create(object)
    • retrieve(id)
    • update(id, object)
    • delete(id)
    • listAll(object)
    • MoveTaskToAnotherTaskType(id, object)

• templates

  • template
    • retrieve(id)

• users

  • user
    • create(object)
    • retrieve(id)
    • retrieveByEmail(email)
    • retrieveByUsername(username)
    • retrieveLoggedIn()
    • update(id, object)
    • delete(id)
    • listAll(object)
  • group
    • create(object)
    • retrieve(id)
    • update(id, object)
    • delete(id)
    • listAll(object)

• webhooks

  • webhook
    • create(object)
    • retrieve(id)
    • update(id, object)
    • delete(id)
    • listAll(object)
    • listAllEvents()