Integration · Marketing

Connect Claude & ChatGPT to Act-On

Ask your AI what a contact has clicked lately, how last week's email performed, or to add someone to a list in Act-On. It can read and update contacts, check lead scores and segments, and work with list records. It can also create email drafts and send a message to a list, with your approval if you want it.

Connect Act-On free

Free plan, no credit card. Takes about a minute.

Try asking

“What has [email protected] done in the last three months?”
The AI lists her recent marketing activity, such as email opens, clicks, website visits and form submits.
“Add Peter Hansen, [email protected], to our webinar list.”
It finds the list ID and adds a record with his email and name to that list.
“How did the April newsletter perform?”
It finds the sent message and reads its report: sent, opened, clicked and bounced.

What your AI can do

Contacts and lists

Search, create and update contacts, read activity, lead scores and segments, and add, update or remove records in your lists.

Email messages

List messages, create and update drafts, pick a sender and send a message to lists or specific records, now or at a set time.

Reports and campaigns

Read message reports, form statistics, campaigns, forms, programs and opt-outs.

“Draft an email announcing our new price list.”
It creates a draft message with a title, subject and body. Nothing is sent until you ask for it.
“Which segments is this lead in, and what is her score?”
It reads the contact's segments and lead scores by email address.
“Who has opted out of email this month?”
It lists the contacts who opted out, filtered by date.

146 tools for Act-On

These tools are switched on when you connect. You can switch any of them off, or require your approval before it runs.

add_list_recordChanges dataAdd a contact to a list by `listid`. Pass `raw_body` as a JSON object of the list's column names, e.g. {"EMAIL": "[email protected]", "FIRSTNAME": "Jane"}.
create_by_fieldChanges dataCreate a new by field. API summary: Get contacts from the Act-On Contacts List specifying the fields to be returned.
create_contactChanges dataAdd a single contact to the Act-On Contacts list. Set `create_contact_method` to EMAIL and pass `email`, plus optional name, company, phone, address and custom fields.
create_data_jsonChanges dataCreate a new json for a data. Required: ingest mode or abort on invalid row. API summary: Ingests a JSON stream for a specific dataset or object.
create_definitionChanges dataCreate a new definition. Required: body account id, import definition name, mappings or merge strategy. API summary: Create an Import Definition.
create_fieldChanges dataCreate a new field. Required: name or type. API summary: Add Field.
create_footerChanges dataCreate a new footer. API summary: Add a new footer.
create_headerChanges dataCreate a new header. API summary: Add a header.
create_imageChanges dataCreate a new image. API summary: Add an image.
create_listChanges dataCreate a new list. Search lists first to avoid duplicates.
create_logoChanges dataCreate a new logo. API summary: Add a logo.
create_medialinkChanges dataCreate a new medialink. API summary: Add a media link.
create_mediumChanges dataCreate a new medium. API summary: Add a media file.
create_messageVisible to othersCreate an email draft or template with `title`, `subject`, `htmlbody` or `textbody`, sender and optional header, footer and logo IDs. Nothing is sent.
create_query_join_with_otherChanges dataCreate a new join with other for a query. API summary: Query data from a Custom Data dataset.
create_schema_fieldChanges dataCreate a new field for a schema. Required: items. API summary: Adds fields to Custom Data schemas.
create_userChanges dataCreate a new user. API summary: Create new account user.
create_v1_schemaChanges dataCreate a new schema for a v1. API summary: Create a Custom Data schema.
create_v2_segmentChanges dataCreate a new segment for a v2. Required: name, parent id or type. API summary: Create a segment.
delete_allsMoves moneyPermanently delete a all by account id. Financial or irreversible action; may require approval. API summary: Deletes all Custom Data schemas.
delete_contactsMoves moneyPermanently delete a contact by segment id. Financial or irreversible action; may require approval. API summary: Remove Contacts from Direct Select Segment by external id.
delete_data_idsMoves moneyPermanently delete a id by data identifier. Financial or irreversible action; may require approval. API summary: Delete records from a dataset based on the provided IDs or ID range.
delete_definitionDeletesPermanently delete a definition by import definition id. Destructive action; may require approval. API summary: Delete Import Definition by Id.
delete_deletesDeletesPermanently delete a delete. Destructive action; may require approval. API summary: Delete account users.
delete_external_idDeletesPermanently delete a external id by external id. Destructive action; may require approval. API summary: Delete contact in the Act-On Contacts List by externalId and object type.
delete_fieldDeletesPermanently delete a field by field id. Destructive action; may require approval. API summary: Delete Field.
delete_footerDeletesPermanently delete a footer by footer id. Destructive action; may require approval.
delete_headerDeletesPermanently delete a header by header id. Destructive action; may require approval.
delete_imageDeletesPermanently delete a image by image id. Destructive action; may require approval. API summary: Delete an image.
delete_listDeletesPermanently delete a list by listid. Destructive action; may require approval.
delete_list_recordDeletesPermanently remove one record from a list by `listid` and `recordid`. This cannot be undone.
delete_list_recordsMoves moneyPermanently delete a record by listid. Financial or irreversible action; may require approval. API summary: Delete records from a list.
delete_logoDeletesPermanently delete a logo by logo id. Destructive action; may require approval.
delete_mediumDeletesPermanently delete a medium by medium id. Destructive action; may require approval. API summary: Delete a media object.
delete_messageDeletesPermanently delete a message by message id. Destructive action; may require approval.
delete_message_delete_contact_in_the_act_on_contacts_list_by_emaDeletesPermanently delete a message by message address. Destructive action; may require approval. API summary: Delete contact in the Act-On Contacts List by email address.
delete_messagesMoves moneyPermanently delete a message by account id. Financial or irreversible action; may require approval. API summary: Delete contacts in the Act-On Contacts List by emails.
delete_optinsMoves moneyPermanently delete a optin. Financial or irreversible action; may require approval. API summary: Remove Opt Outs.
delete_pageDeletesPermanently delete a page by page id. Destructive action; may require approval. API summary: Delete landing page.
delete_schema_fieldsMoves moneyPermanently delete a field by object id. Financial or irreversible action; may require approval. API summary: Deletes fields from Custom Data schemas.
delete_v1_dataDeletesPermanently delete a data by data identifier. Destructive action; may require approval. API summary: Deletes the dataset based on the provided dataset Id.
delete_v1_schemaDeletesPermanently delete a schema by object id. Destructive action; may require approval. API summary: Deletes one Custom Data schema.
delete_v2_segmentDeletesPermanently delete a segment by segment id. Destructive action; may require approval. API summary: Delete Segment.
find_list_recordLook up a contact record in one list by `listid` and `email`. Returns the record ID if it exists.
get_campaignGet one campaign by `campaign_id`, including its assets and results.
get_contactGet one contact from the Act-On Contacts list by its contact ID (`id_id`).
get_contact_by_emailGet a contact from the Act-On Contacts list by email address (`message_address`).
get_contact_scoresGet a contact's lead scores by `email_address`.
get_cookie_idGet one cookie id by cookie id. API summary: Get contact in the Act-On Contacts List by cookie id.
get_customevent_statusGet the current status of a customevent by customevent id. API summary: Get upload custom event status.
get_definitionGet one definition by import definition id. API summary: Get Import Definition by Id.
get_external_idGet one external id by external id. API summary: Get contact in the Act-On Contacts List by externalId and object type.
get_footerGet one footer by footer id. API summary: Get a footer.
get_form_reportGet submission and view statistics for one form by `form_id`.
get_headerGet one header by header id. API summary: Get a header.
get_imageGet one image by image id. API summary: Get an image.
get_list_recordGet one record from a list by `listid` and `recordid`, with all its column values.
get_list_recordsDownload the records (contacts) in one list by `listid`, with optional `limit`, `offset` and created/modified date filters.
get_list_statusGet the current status of a list by jobid. API summary: Get list upload status.
get_logoGet one logo by logo id. API summary: Get a logo.
get_media_message_reportList messages. API summary: Get media message report.
get_mediumGet one medium by medium id. API summary: Get media file.
get_message_html_contentsGet one message by recid. API summary: Get message HTML contents.
get_message_reportGet the delivery and engagement report (sent, opened, clicked, bounced) for one sent message by `message_id`.
get_message_report_2Get one report for a message by drilldown. Results are paginated. API summary: Get message report drilldown.
get_pageGet one page by page id. API summary: Get landing page.
get_reportGet one report by job id. API summary: Download the report for the provided Job Id.
get_statusGet one status by import id. API summary: Get Import status.
get_subscription_opt_outs_by_categoryList optouts. Optional filters: category. Results are paginated. API summary: Get subscription opt-outs by category.
get_v1_dataGet one data for a v1 by data identifier. API summary: Retrieves the details for a dataset using its ID or name.
get_v1_schemaGet one schema for a v1 by object id. API summary: Returns a Custom Data schema.
get_v2_segmentGet one segment for a v2 by segment id. API summary: Get Segment by Id.
list_allsList alls. API summary: Returns all Custom Data schemas.
list_alls_list_all_datasetsList alls. API summary: Retrieves a list of all datasets for the account.
list_campaignsList your Act-On campaigns with their IDs.
list_categoriesList categories. API summary: Get Subscription Categories.
list_contact_activityList a contact's recent marketing activity (email opens, clicks, visits, form submits) by `email_address`, optionally limited by `months_of_past_data`.
list_contact_segmentsList the segments a contact belongs to, by `email_address`.
list_contactsList contacts in the Act-On Contacts list, with `page`, `limit` and created/updated date filters.
list_data_allsList alls for a data. API summary: Retrieves a list of all datasets for a specific schema.
list_definitionsList definitions. API summary: Get Import Definitions.
list_external_id_scoresList scores for a external id. API summary: Get all scores for a contact by externalId and object type.
list_external_id_segmentsList segments for a external id. API summary: Get all segments that the contact belong by externalId and object type.
list_external_id_tasksList tasks for a external id. Optional filters: months of past data. API summary: Get contact history by externalId and object type.
list_footersList footers. API summary: Get footer list.
list_form_urlsList urls for a form. API summary: Get classic form URLs.
list_formsList your Act-On forms with their IDs.
list_hardbouncesList hardbounces. Optional filters: createdbefore or createdafter. Results are paginated. API summary: Get hard bounce list.
list_headersList headers. API summary: Get header list.
list_id_scoresList scores for a id. API summary: Get all scores for a contact by id.
list_id_segmentsList segments for a id. API summary: Get all segments that the contact belong by id.
list_id_tasksList tasks for a id. Optional filters: months of past data. API summary: Get contact history by id.
list_imagesList images. API summary: Get image list.
list_listsList your Act-On contact lists with their IDs and record counts. Optional `listingtype` (e.g. contactlist) narrows the asset type.
list_logosList logos. API summary: Get logo list.
list_mediaList media. API summary: Get media list.
list_medium_reportsList reports for a medium. API summary: Get media report.
list_messagesList email messages (drafts, templates or sent) by `type`, with `limit` and `offset`. Returns message IDs and titles.
list_optoutsList contacts who opted out of email, with `limit`, `offset` and created date filters.
list_page_reportsList reports for a page. API summary: Get landing page report.
list_page_urlsList urls for a page. API summary: Get landing page URLs.
list_pagesList pages. API summary: Get landing page list.
list_programsList your automated programs, optionally filtered by `type`.
list_record_factsList facts for a record. API summary: Get contact history and score.
list_rejected_upload_recordsList rejected upload records. Optional filters: filename. API summary: Get rejected records from an upload.
list_segment_contactsList the contacts in one segment by `segment_id`, with `page` and `limit`.
list_segmentsList segments in the Act-On Contacts list with their IDs, with `page` and `limit`.
list_sendersList the sender names and addresses you can send messages from.
list_sent_message_reportsList reports for recently sent messages, optionally for a `period`.
list_seokeywordsList seokeywords. Optional filters: url. API summary: Get SEO keywords.
list_spamcomplaintsList spamcomplaints. Optional filters: createdbefore or createdafter. Results are paginated. API summary: Get spam complaint list.
list_timelinesList timelines. API summary: Get a media timeline report.
list_v2_schemasList schemas for a v2. Optional filters: skip hidden or skip read only. API summary: Get Schema.
list_viewsList views. API summary: Get a media view report.
remove_contacts_from_direct_select_segment_by_emailMoves moneyPermanently delete a contact by segment id. Financial or irreversible action; may require approval. API summary: Remove Contacts from Direct Select Segment by email.
retrieve_the_status_for_the_job_idGet one status by job id. API summary: Retrieve the status for the Job Id.
search_listsSearch lists by cookie. Use this to find existing lists before creating a new list. API summary: Get contact record ID based on cookie value.
search_seoreportsSearch seoreports by keyword or url. Use this to find existing seoreports before creating a new seoreport. API summary: Get a new SEO report.
send_messageVisible to othersSend an email message by `msgid` to whole lists (`sendtoids`) or specific records (`sendtorecids`), now or at a scheduled `when` (UNIX timestamp). This emails real recipients and cannot be recalled.
send_message_2Visible to othersSend a message (msgid). Has effects visible outside this system. API summary: Resend a message.
update_contact_by_emailVisible to othersUpdate a contact in the Act-On Contacts list by email address (`message_address`). Only the fields you pass change.
update_contactsVisible to othersUpdate an existing contact identified by segment id. Has effects visible outside this system. API summary: Add Contacts to a Direct Select Segment By External id.
update_definitionChanges dataUpdate an existing definition identified by import definition id. API summary: Update an Import Definition.
update_external_idVisible to othersUpdate an existing external id identified by external id. Has effects visible outside this system. API summary: Update contact in the Act-On Contacts list by externalId & objectType, fallback to email match.
update_fieldChanges dataUpdate an existing field identified by field id. API summary: Update FieldDefinition.
update_footerChanges dataUpdate an existing footer identified by footer id. API summary: Update a footer.
update_headerChanges dataUpdate an existing header identified by header id. API summary: Update a header.
update_idChanges dataUpdate an existing id identified by id id. API summary: Update contact in the Act-On Contacts List by id.
update_imageChanges dataUpdate an existing image identified by image id. API summary: Update an image.
update_listChanges dataUpdate an existing list identified by listid. API summary: Update or merge a list.
update_list_recordChanges dataUpdate one record in a list by `listid` and `recordid`. Pass `raw_body` as a JSON object of the columns to change.
update_list_recordsDeletesUpdate an existing record identified by listid. Destructive action; may require approval. API summary: Upsert a contact record by email.
update_logoChanges dataUpdate an existing logo identified by logo id. API summary: Update a logo.
update_mediumChanges dataUpdate an existing medium identified by medium id. API summary: Update Media File.
update_messageVisible to othersUpdate a draft message's `title`, `subject`, `htmlbody` or `textbody` by `message_id`.
update_message_ete_requestVisible to othersUpdate an existing message identified by templateid. Has effects visible outside this system. API summary: ETE Request.
update_optoutsVisible to othersUpdate an existing optout. Has effects visible outside this system. API summary: Update optout list.
update_schema_fieldsVisible to othersUpdate an existing field identified by object id. Has effects visible outside this system. API summary: Updates Custom Data schema field properties.
update_segment_contactsVisible to othersUpdate an existing contact identified by segment id. Has effects visible outside this system. API summary: Add Contacts to a Direct Select Segment.
update_setcategoriesDeletesUpdate an existing setcategory. Destructive action; may require approval. API summary: Set Multiple Subscriptions by email address.
update_v1_dataChanges dataUpdate an existing data identified by object id. API summary: Creates a new dataset for a Custom Data schema.
update_v1_data_update_datasetChanges dataUpdate an existing data identified by data identifier. API summary: Updates a dataset's name and description.
update_v1_schemaChanges dataUpdate an existing schema identified by object id. API summary: Updates a Custom Data schema basic properties.
update_v2_segmentChanges dataUpdate an existing segment identified by segment id. API summary: Update Segment. If it's a Direct Select Segment, only the name can be updated.
upload_contactChanges dataUpload a contact (import definition id). API summary: Import Contacts.
upload_customeventChanges dataUpload a customevent. API summary: Upload custom events.

Set up in three steps

1
Pick the app
Create a free HeyMyApps account and choose Act-On from the app list.
2
Paste your key
Enter four fields: Client ID, Client Secret, and the email and password of the Act-On user the AI should act as. You find the Client ID and Client Secret in Act-On under Settings > Other Settings > Custom Account Settings > API Access Keys. Your numeric Act-On account ID is optional, but the tools for the Act-On Contacts list and segments need it.
3
Add the link to your AI
You get a personal MCP link. Add it to Claude, ChatGPT or Cursor:
1. Click your name, then Settings › Connectors › Add custom connector.
2. Paste your link as the Remote MCP server URL.
3. Switch it on from the + menu in a chat.

Questions

What can the AI do in Act-On?

It can read your lists and their records, contacts in the Act-On Contacts list, contact activity, lead scores and segments, email messages and their reports, campaigns, forms, senders, opt-outs and programs. It can add, update and delete list records, create and update contacts, create and update email drafts, and send a message to lists or records.

Does the AI see my Act-On credentials?

No. Your Act-On credentials are encrypted at rest and never shown to the AI. After you save them, they are not shown again, not even to you. The AI only sees the results of the tools it calls.

Can I control what the AI is allowed to do?

Yes. You choose which tools are switched on, so you can start with lookups only. Sending a message emails real recipients and cannot be recalled, and deleting a list record is permanent, so both can require your approval before they run. Every tool call is logged.

Does it work with ChatGPT?

Yes. In ChatGPT, open Settings › Apps & Connectors › Advanced, turn on Developer mode and add your HeyMyApps link. Developer mode needs a paid ChatGPT plan: Plus, Pro, Business or Enterprise. The same link also works in Claude (Settings › Connectors › Add custom connector), Cursor and other MCP clients.

What does it cost?

HeyMyApps has a free plan with no credit card required. Paid plans bill per completed task. You also need your own Act-On account.

Why does Act-On need a username and password?

Act-On issues access tokens for a specific user. HeyMyApps sends your Client ID and Client Secret together with that user's email and password to Act-On to get a token, and renews it when it expires. The AI then works with that user's access in Act-On.