ActiveCampaign Contacts API

The Contacts API from ActiveCampaign — 28 operation(s) for contacts.

Documentation GitHub OpenAPI

Operations 36

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /contacts Create a new contact · ActiveCampaign Create a Contact #

Ask an LLM

“How do I add a brand-new contact to my account through the API?”

“What happens if I try to create a contact whose email already exists?”

Tell an agent

Create a new contact from these details: {contact}.

Add a new person to my contacts with the name and email I give you.

GET /contacts Search and filter contacts · ActiveCampaign List, Search, and Filter Contacts #

Ask an LLM

“How do I find contacts in ActiveCampaign by email address or phone number?”

“Can I pull only the contacts that carry a certain tag or sit on a certain list?”

Tell an agent

Find the contact with email {email}.

List contacts on list {listid} that have tag {tagid}.

POST /contact/sync Create or update a contact by email · ActiveCampaign Sync a Contact's Data #

Ask an LLM

“Can I upsert a contact so it is created if new and updated if the email already exists?”

“Which call syncs a contact's data without me checking whether they exist first?”

Tell an agent

Sync this contact, creating or updating it by email: {contact}.

Upsert the contact record for the email in my payload and merge in the new fields.

GET /contacts/{id} Retrieve a contact · ActiveCampaign Retrieve a Contact #

Ask an LLM

“How do I look up one contact's full record when I know its ID?”

“What details come back when I fetch a single contact?”

Tell an agent

Get contact {id}.

Show me the full record for contact ID {id}.

PUT /contacts/{id} Update an existing contact · ActiveCampaign Update a Contact #

Ask an LLM

“How do I change the name or phone on a contact I already have the ID for?”

“Can I edit an existing contact's details by its ID?”

Tell an agent

Update contact {id} with {contact}.

Change the phone number on existing contact {id}.

DELETE /contacts/{id} Delete a contact · ActiveCampaign Delete a Contact #

Ask an LLM

“How do I permanently remove a contact from my account?”

“Is deleting a contact by ID reversible?”

Tell an agent destructive · confirm first

Delete contact {id}.

Remove the contact with ID {id} from my account entirely.

POST /contactLists Subscribe or unsubscribe a contact from a list · ActiveCampaign Update List Status for a Contact #

Ask an LLM

“How do I subscribe a contact to one of my mailing lists?”

“Can I unsubscribe someone from a single list without deleting them?”

Tell an agent

Set this contact's list subscription status: {contactList}.

Unsubscribe the contact from the newsletter list using the list and contact IDs I give you.

GET /contacts/{id}/contactAutomations List the automations one contact is in · ActiveCampaign List All Automations the Contact is in #

Ask an LLM

“Which automations is a particular contact currently enrolled in?”

“Can I see every automation a given contact has entered?”

Tell an agent

Show the automations contact {id} is enrolled in.

List every automation that contact {id} has been added to.

GET /contacts/{id}/scoreValues Get a contact's score values · ActiveCampaign Retrieve a Contact's Score Value #

Ask an LLM

“What lead score does a specific contact currently have?”

“Can I read a contact's scoring values by contact ID?”

Tell an agent

Get the score values for contact {id}.

Show me how contact {id} is scored.

GET /contacts/{id}/bounceLogs Get a contact's email bounce logs · ActiveCampaign Retrieve a Contact's Bounce Logs #

Ask an LLM

“Why are emails to a contact bouncing, and where can I see the bounce history?”

“Can I pull the bounce log for one contact?”

Tell an agent

Show the bounce logs for contact {id}.

Check whether emails to contact {id} have bounced.

GET /contacts/{id}/contactData Get a contact's data record · ActiveCampaign Retrieve a Contact's Data #

Ask an LLM

“Where do I get the extra contact data stored alongside a contact?”

“Can I fetch the contactData object for a single contact?”

Tell an agent

Get the contact data record for contact {id}.

Pull the stored contactData for contact {id}.

GET /contacts/{id}/contactGoals Get the automation goals a contact reached · ActiveCampaign Retrieve a Contact's Goals #

Ask an LLM

“Which automation goals has a contact hit so far?”

“Can I see a contact's goal completions?”

Tell an agent

List the goals for contact {id}.

Show which goals contact {id} has achieved.

GET /contacts/{id}/contactLists Get the lists a contact belongs to · ActiveCampaign Retrieve a Contact's List Memberships #

Ask an LLM

“What mailing lists is a given contact subscribed to?”

“Can I check a contact's subscription status on each of my lists?”

Tell an agent

Show the list memberships for contact {id}.

Tell me which lists contact {id} is on.

GET /contacts/{id}/contactLogs Get a contact's activity logs · ActiveCampaign Retrieve a Contact's Logs #

Ask an LLM

“Where can I see the activity log recorded for one contact?”

“Can I pull the contactLogs history for a contact?”

Tell an agent

Get the contact logs for contact {id}.

Show the logged history of contact {id}.

GET /contacts/{id}/contactDeals List deals where a contact is a secondary contact · ActiveCampaign Retrieve a List of Contact's Deals #

Ask an LLM

“Which deals list a particular person as a secondary contact?”

“Can I see the contactDeals links for one contact?”

Tell an agent

List the contact-deal associations for contact {id}.

Show the deals contact {id} is attached to as a secondary contact.

GET /contacts/{id}/deals Get the deals owned by a contact · ActiveCampaign Retrieve a Contact's Deals #

Ask an LLM

“What deals are in the pipeline for a specific contact?”

“Can I list the deals where a contact is the primary contact?”

Tell an agent

Get the deals for contact {id}.

Show the pipeline deals where contact {id} is the primary contact.

GET /contacts/{id}/fieldValues Get a contact's custom field values · ActiveCampaign Retrieve a Contact's Field Values #

Ask an LLM

“How do I read the custom field values filled in for a contact?”

“Can I see every custom field value one contact has?”

Tell an agent

Get the custom field values for contact {id}.

Show what custom fields are filled in on contact {id}.

GET /contacts/{id}/geoIps Get a contact's geo-IP locations · ActiveCampaign Retrieve a Contacts List of Geo-ips #

Ask an LLM

“Where in the world has a contact opened emails or visited from, based on IP?”

“Can I pull the geo-IP records for one contact?”

Tell an agent

List the geo-IP records for contact {id}.

Show the locations tied to contact {id}'s IP addresses.

GET /contacts/{id}/notes Get the notes on a contact · ActiveCampaign Retrieve a Contacts Notes #

Ask an LLM

“How do I read the notes my team has left on a contact?”

“Can I pull all notes attached to one contact?”

Tell an agent

Get the notes on contact {id}.

Show every note written about contact {id}.

GET /contacts/{id}/organization Get a contact's organization · ActiveCampaign Retrieve a Contacts Organization #

Ask an LLM

“Which organization is a contact linked to?”

“Can I look up the company record for a given contact?”

Tell an agent

Get the organization for contact {id}.

Show which company contact {id} belongs to.

GET /contacts/{id}/plusAppend Get a contact's Plus Append data · ActiveCampaign Retrieve a Contacts Plus Append #

Ask an LLM

“Where do I find the Plus Append enrichment data for a contact?”

“Can I read the appended profile details for one contact?”

Tell an agent

Get the Plus Append data for contact {id}.

Show the appended social profile info for contact {id}.

GET /contacts/{id}/trackingLogs Get a contact's tracking logs · ActiveCampaign Retrieve a Contacts Tracking Logs #

Ask an LLM

“What tracked activity, like opens and site visits, is logged for a contact?”

“Can I see the tracking log for a contact using the contact id path?”

Tell an agent

Get the tracking logs for contact {id}.

Show the tracked activity recorded for contact {id}.

GET /contacts/{id}/accountContacts Get a contact's account associations · ActiveCampaign Retrieve a Contacts Account Contacts #

Ask an LLM

“Which accounts is a contact associated with?”

“Can I list the account-contact links for one person?”

Tell an agent

List the account associations for contact {id}.

Show which accounts contact {id} is linked to.

GET /contacts/{id}/automationEntryCounts Count how often a contact entered automations · ActiveCampaign Retrieve a Contacts Automation Entry Counts #

Ask an LLM

“How many times has a contact entered each automation?”

“Can I see automation entry counts for a single contact?”

Tell an agent

Get the automation entry counts for contact {id}.

Tell me how many times contact {id} has entered each automation.

POST /contactAutomations Add a contact to an automation · ActiveCampaign Add a Contact to an Automation #

Ask an LLM

“How do I drop a contact into an automation through the API?”

“Can I enroll a contact in a specific automation manually?”

Tell an agent

Add a contact to an automation: {contactAutomation}.

Enroll the contact I name into the welcome automation.

GET /contactAutomations List all contact automation enrollments · ActiveCampaign List All Automations a Contact is in #

Ask an LLM

“Can I list every contact-to-automation enrollment across my whole account?”

“Where do I get all contactAutomation records at once?”

Tell an agent

List all contact automation enrollments in my account.

Show every contactAutomation record across all contacts.

GET /contactAutomations/{id} Retrieve one contact automation enrollment · ActiveCampaign Retrieve an Automation a Contact is in #

Ask an LLM

“How do I look up a single contact-automation enrollment by its ID?”

“Can I check the status of one contactAutomation record?”

Tell an agent

Get contact automation enrollment {id}.

Show the details of contactAutomation {id}.

DELETE /contactAutomations/{id} Remove a contact from an automation · ActiveCampaign Remove a Contact from an Automation #

Ask an LLM

“How do I take a contact out of an automation they are in?”

“Can I end a contact's enrollment in an automation early?”

Tell an agent destructive · confirm first

Remove the contact from the automation by deleting enrollment {id}.

Delete contactAutomation {id}.

POST /contactTags Add a tag to a contact · ActiveCampaign Add a Tag to Contact #

Ask an LLM

“How do I tag a contact through the API?”

“Can I apply an existing tag to a contact by IDs?”

Tell an agent

Tag a contact: {contactTag}.

Apply the VIP tag to the contact I name.

DELETE /contactTags/{id} Remove a tag from a contact · ActiveCampaign Remove a Tag from a Contact #

Ask an LLM

“How do I untag a contact without deleting the tag itself?”

“Can I remove one tag from a contact using the contactTag ID?”

Tell an agent destructive · confirm first

Remove contact tag {id}.

Untag the contact by deleting contactTag {id}.

POST /contactDeals Add a secondary contact to a deal · ActiveCampaign Create a Secondary Contact #

Ask an LLM

“How do I attach another person to a deal as a secondary contact?”

“Can I link a second contact to an existing deal?”

Tell an agent

Add a secondary contact to a deal: {contactDeal}.

Attach the contact I name to the deal as a secondary contact.

GET /contactDeals List all secondary contacts on deals · ActiveCampaign List All Secondary Contacts #

Ask an LLM

“Where can I see every secondary contact attached to deals across my pipelines?”

“Can I list all deal secondary contacts at once?”

Tell an agent

List all secondary contacts across my deals.

Show every contactDeal secondary-contact record in the account.

GET /contactDeals/{id} Retrieve a deal's secondary contact · ActiveCampaign Retrieve a Secondary Contact #

Ask an LLM

“How do I fetch one secondary-contact record by its ID?”

“What does a single deal secondary contact look like?”

Tell an agent

Get secondary contact {id}.

Show the deal secondary-contact record {id}.

PUT /contactDeals/{id} Update a deal's secondary contact · ActiveCampaign Update a Secondary Contact #

Ask an LLM

“Can I change the role of a secondary contact already on a deal?”

“How do I edit an existing secondary-contact record?”

Tell an agent

Update secondary contact {id} with {contactDeal}.

Change the role on deal secondary contact {id}.

DELETE /contactDeals/{id} Remove a secondary contact from a deal · ActiveCampaign Delete a Secondary Contact #

Ask an LLM

“How do I detach a secondary contact from a deal?”

“Can I delete a secondary-contact link without deleting the person?”

Tell an agent destructive · confirm first

Delete secondary contact {id}.

Remove deal secondary contact {id}.

GET /contacts/{contactId}/trackingLogs Get a contact's tracked events log · ActiveCampaign Get Contact's Tracking Logs/Events #

Ask an LLM

“Can I get a log of tracked events for a contact using the contactId path variant?”

“Which events have been tracked against a contact over time?”

Tell an agent

Get the event log for contact {contactId}.

List the tracked events recorded for contactId {contactId}.

ActiveCampaign Contacts API

Operations 36

Documentation

Specifications

Schemas & Data

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification