Skip to main content

Intro

Act-On is a marketing automation platform designed to coordinate inbound and outbound marketing campaigns. To learn more about the Act-On API, visit their page (https://developer.act-on.com/reference/api-overview ). You connect to your Act-On account in the Data Center. This topic discusses the fields and menus that are specific to the Act-On connector user interface. General information for adding DataSets, setting update schedules, and editing DataSet information is discussed in Adding a DataSet Using a Data Connector.

Prerequisites

To connect to your Act-On account and create a DataSet, you must select the Region.

Connecting to Your Act-On Account

This section enumerates the options in the Credentials and Details panes in the Act-On Connector page. The components of the other panes in this page, Scheduling and Name & Describe Your DataSet, are universal across most connector types and are discussed in greater length in Adding a DataSet Using a Data Connector.

Credentials Pane

The Act-On API supports Oauth mechanism. This pane contains fields for entering credentials to connect to your Act-On account. The following table describes what is needed for each field:

Field

Description

Region

Select the region. The Default option will use the base URL: https://api.actonsoftware.com in your requests. The EU option will use the EU base URL: https://api-eu.actonsoftware.com in your requests.

Once you have entered valid Act-On credentials, you can use the same account any time you go to create a new Act-On DataSet. You can manage connector accounts in the Accounts tab in the Data Center. For more information about this tab, see Managing User Accounts for Connectors.

Details Pane

This pane contains a primary Reports menu, along with various other menus which may or may not appear depending on the report type you select.

Menu

Description

Report

Select the Act-On report you want to run. The following reports are available:

All Contacts Details

Returns the details of Contacts using List API.

Campaign Message

Returns campaign messages.

Campaign Message List All Types

Returns a campaign messages list of all types.

Campaign Message Report

Returns campaign message report data.

Campaign Message Report Drilldown

Returns a campaign message drilldown report.

Campaign Message Rollup

Returns campaign message rollup data.

Contact API Subscription Category

Returns a list of contact API subscription categories.

Contact By Email Id

Returns contacts from the list for the entered email Id.

Contact Fact and Score Data

Returns the facts and score the available contacts in the list.

Content API Form List

Returns a list of content API forms.

Content API Form Report

Returns content API form report data.

Content API Header Fetch

Returns content API header fetch data.

Content API Header List

Returns a list of content API headers.

Content API Image Fetch

Returns content API image fetch data.

Content API Image List

Returns a list of content API images.

Content API Logo List

Returns a list of content API logos.

Content API Media List

Returns a list of content API media.

Content API Media Message Drilldown

Returns content API media message drilldown data.

Content API Media Rollup Report

Returns content API media rollup report data.

Content API Media Timeline Drilldown

Returns content API media timeline drilldown data.

Content API Media Views Drilldown

Returns content API media views drilldown data.

Content API Page List

Returns a list of content API pages.

Content API Page Report

Returns content API page report data.

Content API Page URLs

Returns a list of content API page URLs.

Content API Promotional URLs

Returns a list of content API promotional URLs.

Fact API Contact Record Facts

Returns a list of fact API content record facts.

Fact API List Optout

Returns fact API list optout data.

List API

Returns list API data.

List API Hard Bounce

Returns list API hard bounce data.

List API Spam Complaint

Returns list API spam complaint data.

Messages By Campaign

Returns the messages reports related to the selected campaign.

SEO API Keywords

Returns a list of SEO API keywords.

Email Id

Enter your email address to get all available contacts from your lists.

Note: You can find your email address in the E-mail Address column of the All contacts details report.

Fetch contacts for List IDs

Parameter Description
All Source IDs Returns the contact details of all present source IDs.
Specifc Source Ids Returns the contact details of selected Source IDs.

Source Id

Select the SourceIds associated with the account.

Campaigns

Select the Campaign associated with the account.

Option to Expand

Parameters Description
Score Details Expands the list of score details of the specific contacts.
List of Activities Expands the list of activities for the contacts.

Listing Type

Select the type of content list you want to pull into your report.

Period

Select a filter for your data.

Date

Select the date for your report. Note that this is a monthly report so only the month and year will be used.

List Id Selection Criteria

Select whether to retrieve data for all or some list IDs.

List ID

Select the list IDs to report.

Other Panes

For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see Adding a DataSet Using a Data Connector.

FAQ