Query structured spec data via REST or MCP. Get exactly what your agent needs.
https://{youraccountname}.api-us1.com/api/3
/accountContacts
Create a new account association
application/json
AccountCreateAssociationRequest
| Property | Type | Required |
|---|---|---|
| accountContact | object | optional |
| └ account | integer | required |
| └ contact | integer | required |
| └ jobTitle | string | optional |
201
422
POST /accountContacts
/accounts
Create a new account
application/json
AccountCreateNewAccountRequest
| Property | Type | Required |
|---|---|---|
| account | object | optional |
| └ name | string | required |
| └ owner | integer | optional |
| └ fields | array | optional |
| └ fieldValue | string | required |
| └ customFieldId | integer | required |
| └ fieldCurrency | string | optional |
| └ accountUrl | string | optional |
201
422
POST /accounts
/addresses
application/json
AddressCreateNewAddressRequest
| Property | Type | Required |
|---|---|---|
| address | object | optional |
| └ zip | string | optional |
| └ city | string | optional |
| └ state | string | optional |
| └ global | string | optional |
| └ country | string | required |
| └ groupid | integer | optional |
| └ allgroup | integer | optional |
| └ district | string | optional |
| └ address_1 | string | required |
| └ address_2 | string | optional |
| └ is_default | boolean | optional |
| └ company_name | string | required |
200
400
POST /addresses
/calendars
application/json
CalendarCreateFeedRequest
| Property | Type | Required |
|---|---|---|
| calendar | object | optional |
| └ type | string | required |
| └ title | string | required |
| └ notification | boolean | optional |
200
POST /calendars
/connections
Create a new connection resource.
application/json
ConnectionCreateNewResourceRequest
200
POST /connections
/contact/sync
application/json
ContactSyncDataRequest
201
400
POST /contact/sync
/contactAutomations
application/json
ContactAddToAutomationRequest
201
403
POST /contactAutomations
/contacts
application/json
ContactCreateNewContactRequest
201
404
422
POST /contacts
/import/bulk_import
application/json
ContactBulkImportContactsRequest
200
400
POST /import/bulk_import
/ecomCustomers
Create a new e-commerce customer resource.
application/json
CustomerCreateNewCustomerRequest
201
400
POST /ecomCustomers
/contactDeals
Create a new secondary contact for a deal
application/json
DealCreateSecondaryContactRequest
200
422
POST /contactDeals
/dealCustomFieldData
application/json
DealCreateCustomFieldValueRequest
200
422
POST /dealCustomFieldData
/dealCustomFieldData/bulkCreate
application/json
DealBulkCreateCustomFieldValuesRequest
200
POST /dealCustomFieldData/bulkCreate
/dealCustomFieldMeta
application/json
DealCreateCustomFieldMetaRequest
200
422
POST /dealCustomFieldMeta
/dealGroups
Create a new pipeline
application/json
DealCreatePipelineRequest
200
400
POST /dealGroups
/dealRoles
application/json
DealRoleCreationRequest
200
400
POST /dealRoles
/dealStages
Create a new stage for a pipeline
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| reorder | query | optional | integer | Whether to reorder stages within the pipeline after creating a new deal stage. Can be one of |
application/json
DealCreateStageRequest
200
400
POST /dealStages
/dealTasks
Create a new task
application/json
DealCreateNewTaskRequest
201
400
POST /dealTasks
/dealTasktypes
Create a new task type
application/json
DealCreateTaskTypeRequest
200
400
POST /dealTasktypes
/deals
Create a new deal
application/json
DealNewDealCreationRequest
201
400
POST /deals
/deals/{id}/notes
Create a new note for a deal
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| id | path | required | string | The Deal’s id to assign new note to |
application/json
DealCreateNoteRequest
201
POST /deals/{id}/notes
/event
Track an event using event tracking. Event Tracking must be toggled on in your ActiveCampaign account on “Website” -> “Site Tracking” (scroll down to Event tracking) in order for this call to work.
application/json
EventTrackEventRequest
200
400
POST /event
/eventTrackingEvents
Create a new event tracking event (name only)
application/json
EventCreateNewEventRequest
201
POST /eventTrackingEvents
/accountCustomFieldData
application/json
FieldCreateCustomFieldValueRequest
| Property | Type | Required |
|---|---|---|
| accountCustomFieldDatum | object | optional |
| └ fieldValue | string | required |
| └ customFieldId | integer | required |
| └ fieldCurrency | string | optional |
| └ customerAccountId | integer | required |
200
POST /accountCustomFieldData
/accountCustomFieldData/bulkCreate
application/json
FieldBulkCreateCustomAccountFieldValueRequest
| Property | Type | Required |
|---|---|---|
| array | object | optional |
| └ fieldValue | string | required |
| └ customFieldId | integer | required |
| └ fieldCurrency | string | optional |
| └ customerAccountId | integer | required |
200
POST /accountCustomFieldData/bulkCreate
/accountCustomFieldMeta
application/json
FieldCreateCustomFieldMetaRequest
| Property | Type | Required |
|---|---|---|
| accountCustomFieldMetum | object | optional |
| └ fieldType | string | required |
| └ fieldLabel | string | required |
| └ displayOrder | integer | optional |
| └ fieldDefault | string | optional |
| └ fieldOptions | array | optional |
| └ isFormVisible | boolean | optional |
| └ fieldDefaultCurrency | string | optional |
200
422
POST /accountCustomFieldMeta
/fieldOption/bulk
application/json
FieldCreateCustomFieldOptionsRequest
201
422
POST /fieldOption/bulk
/fieldValues
application/json
FieldCreateCustomValueRequest
200
403
POST /fieldValues
/fields
application/json
FieldCreateCustomFieldRequest
201
403
422
POST /fields
/groupMembers
application/json
FieldAddGroupMemberRequest
200
403
404
422
POST /groupMembers
/groups
application/json
GroupCreateNewGroupRequest
200
POST /groups
/contactLists
Subscribe a contact to a list or unsubscribe a contact from a list.
application/json
ListUpdateListStatusForContactRequest
200
400
POST /contactLists
/fieldRels
application/json
ListCreateFieldRelationshipToListsRequest
201
403
POST /fieldRels
/listGroups
application/json
ListGroupPermissionCreateRequest
201
403
POST /listGroups
/lists
application/json
ListCreateNewListRequest
200
400
403
POST /lists
/siteTrackingDomains
Add a domain to the site tracking whitelist
application/json
ListWhitelistedDomainCreateRequest
200
400
POST /siteTrackingDomains
/messages
application/json
MessageCreateNewMessageRequest
| Property | Type | Required |
|---|---|---|
| message | object | optional |
| string | required | |
| └ reply2 | string | required |
| └ subject | string | optional |
| └ fromname | string | required |
| └ preheader_text | string | optional |
201
400
POST /messages
/accounts/{id}/notes
Create a new note for an account
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| id | path | required | string | Account’s id to assign new note to |
application/json
NoteCreateAccountNoteRequest
| Property | Type | Required |
|---|---|---|
| note | object | optional |
| └ note | string | required |
201
POST /accounts/{id}/notes
/notes
application/json
NoteCreateNewRequest
201
400
POST /notes
/ecomOrders
Create a new e-commerce order resource.
application/json
OrderCreateNewOrderRequest
201
POST /ecomOrders
/taskOutcomes
Create a new task outcome
application/json
OutcomeCreateTaskOutcomeRequest
200
422
POST /taskOutcomes
/taskNotifications
Create a new task outcome
application/json
ReminderCreateTaskOutcomeRequest
200
422
POST /taskNotifications
/savedResponses
application/json
ResponseCreateSavedResponseRequest
201
422
POST /savedResponses
/customObjects/records/{schemaId}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| schemaId | path | required | string | ID of schema |
application/json
SchemaCreateOrUpdateRecordRequest
201
400
422
POST /customObjects/records/{schemaId}
/customObjects/schemas
application/json
SchemaCreateNewRequest
201
422
POST /customObjects/schemas
/customObjects/schemas/public
application/json
SchemaCreatePublicSchemaRequest
200
400
POST /customObjects/schemas/public
/customObjects/schemas/{id}/child
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| id | path | required | string | Id of the parent schema the new child schema will extend |
200
400
POST /customObjects/schemas/{id}/child
/contactTags
Create a contact tag object
application/json
TagAddContactTagRequest
201
404
422
POST /contactTags
/tags
application/json
TagCreateTagRequest
201
POST /tags
/users
Create a new user
application/json
UserCreateNewUserRequest
201
400
POST /users
/webhooks
Create a new webhook
application/json
WebhookCreateNewWebhookRequest
201
POST /webhooks
AccountCreateAssociationRequest
{
"type": "object",
"properties": {
"accountContact": {
"type": "object",
"required": [
"account",
"contact"
],
"properties": {
"account": {
"type": "integer",
"format": "int32",
"description": "Account ID"
},
"contact": {
"type": "integer",
"format": "int32",
"description": "Contact ID"
},
"jobTitle": {
"type": "string",
"description": "Job Title of the contact at the account"
}
}
}
}
}
AccountCreateNewAccountRequest
{
"type": "object",
"properties": {
"account": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Account's name"
},
"owner": {
"type": "integer",
"format": "int32",
"default": 1,
"description": "The userId of the account owner."
},
"fields": {
"type": "array",
"items": {
"type": "object",
"required": [
"customFieldId",
"fieldValue"
],
"properties": {
"fieldValue": {
"type": "string",
"description": "Updated field value. For `currency` field, this needs to be in cents not dollars (or 100 x Base Unit)."
},
"customFieldId": {
"type": "integer",
"format": "int32",
"description": "Field ID, ID of the Custom Field Meta Data"
},
"fieldCurrency": {
"type": "string",
"description": "Required only for the `currency` field type. The three letter currency code for the currency value"
}
}
},
"description": "Account's custom field values `{customFieldId: int, fieldValue: string, fieldCurrency?:string}[]`"
},
"accountUrl": {
"type": "string",
"description": "Account's website"
}
}
}
}
}
AccountUpdateAssociationRequest
{
"type": "object",
"properties": {
"accountContact": {
"type": "object",
"required": [
"account",
"contact"
],
"properties": {
"account": {
"type": "integer",
"format": "int32",
"description": "Account ID"
},
"contact": {
"type": "integer",
"format": "int32",
"description": "Contact ID"
},
"jobTitle": {
"type": "string",
"description": "Job Title of the contact at the account"
}
}
}
}
}
AccountUpdateExistingRequest
{
"type": "object",
"properties": {
"account": {
"type": "object",
"required": [],
"properties": {
"name": {
"type": "string",
"description": "Account's name"
},
"owner": {
"type": "integer",
"format": "int32",
"default": 1,
"description": "The userId of the Account owner."
},
"fields": {
"type": "array",
"items": {
"type": "object",
"required": [
"customFieldId",
"fieldValue"
],
"properties": {
"fieldValue": {
"type": "string",
"description": "Updated field value. For `currency` field, this needs to be in cents not dollars (or 100 x Base Unit)."
},
"customFieldId": {
"type": "integer",
"format": "int32",
"description": "Field ID, ID of the Custom Field Meta Data"
},
"fieldCurrency": {
"type": "string",
"description": "Required only for the `currency` field type. The three letter currency code for the currency value"
}
}
},
"description": "Account's custom field values `{customFieldId: int, fieldValue: string, fieldCurrency?:string}[]`"
},
"accountUrl": {
"type": "string",
"description": "Account's website"
}
}
}
}
}
AddressCreateNewAddressRequest
{
"type": "object",
"properties": {
"address": {
"type": "object",
"required": [
"company_name",
"address_1",
"country"
],
"properties": {
"zip": {
"type": "string"
},
"city": {
"type": "string"
},
"state": {
"type": "string"
},
"global": {
"type": "string"
},
"country": {
"type": "string",
"description": "Accepts a (2) two character string - country code (eg 'US', 'CA', 'MX')"
},
"groupid": {
"type": "integer",
"format": "int32"
},
"allgroup": {
"type": "integer",
"format": "int32"
},
"district": {
"type": "string",
"description": "(Optional for countries that use it)"
},
"address_1": {
"type": "string"
},
"address_2": {
"type": "string"
},
"is_default": {
"type": "boolean",
"description": "Indicates default address"
},
"company_name": {
"type": "string"
}
}
}
}
}
AddressUpdateAddressRequest
{
"type": "object",
"properties": {
"address": {
"type": "object",
"required": [
"company_name",
"address_1",
"country"
],
"properties": {
"zip": {
"type": "string"
},
"city": {
"type": "string"
},
"state": {
"type": "string"
},
"global": {
"type": "string"
},
"country": {
"type": "string",
"description": "Accepts a (2) two character string - country code (eg 'US', 'CA', 'MX')"
},
"groupid": {
"type": "integer",
"format": "int32"
},
"allgroup": {
"type": "integer",
"format": "int32"
},
"district": {
"type": "string",
"description": "(Optional for countries that use it)"
},
"address_1": {
"type": "string"
},
"address_2": {
"type": "string"
},
"is_default": {
"type": "boolean",
"description": "Indicates default address"
},
"company_name": {
"type": "string"
}
}
}
}
}
BrandingUpdateExistingResourceRequest
{
"type": "object",
"properties": {
"branding": {
"type": "object",
"required": [],
"properties": {
"help": {
"type": "string"
},
"links": {
"type": "boolean",
"description": "External links. To enable (which is the default) exclude this parameter entirely. To disable (remove our branding), just pass this parameter with any value."
},
"favicon": {
"type": "string",
"description": "URL of the favicon."
},
"groupid": {
"type": "integer",
"format": "int32",
"default": 3,
"description": "The group ID. This value will always be 3."
},
"license": {
"type": "boolean",
"description": "unknown"
},
"version": {
"type": "boolean",
"description": "unknown"
},
"siteLogo": {
"type": "string"
},
"siteName": {
"type": "string",
"description": "Title of software. Example: 'ActiveCampaign Email Marketing'"
},
"copyright": {
"type": "boolean",
"description": "unknown"
},
"siteLogoSmall": {
"type": "string",
"description": "URL of small logo. Small logos appear in the header of the admin panel."
},
"footerHtmlValue": {
"type": "string",
"description": "Content of non-removeable footer. Example: <p>footer content here</p>"
},
"footerTextValue": {
"type": "string",
"description": "Content of non-removeable footer. Example: text footer content"
},
"headerHtmlValue": {
"type": "string",
"description": "Content of non-removable header. Example: <p>header content here</p>"
},
"headerTextValue": {
"type": "string",
"description": "Content of non-removable header. Example: text header content"
},
"adminTemplateCss": {
"type": "string",
"description": "The actual CSS. Example: test color: green; (ONLY AVAILABLE FOR CERTAIN PLANS)"
},
"adminTemplateHtm": {
"type": "string",
"description": "The actual HTML template (ONLY AVAILABLE FOR CERTAIN PLANS)"
},
"publicTemplateCss": {
"type": "string",
"description": "The actual CSS. Example: test color: green; (ONLY AVAILABLE FOR CERTAIN PLANS)"
},
"publicTemplateHtm": {
"type": "string",
"description": "The actual HTML template (ONLY AVAILABLE FOR CERTAIN PLANS)"
}
}
}
}
}
CalendarCreateFeedRequest
{
"type": "object",
"properties": {
"calendar": {
"type": "object",
"required": [
"title",
"type"
],
"properties": {
"type": {
"type": "string",
"description": "Possible Values: 'All', 'Deals', or 'Contacts'"
},
"title": {
"type": "string",
"description": "Title of the calendar feed"
},
"notification": {
"type": "boolean",
"description": "Whether or not this calendar has notifications"
}
}
}
}
}
CalendarUpdateFeedRequest
{
"type": "object",
"properties": {
"calendar": {
"type": "object",
"required": [],
"properties": {
"type": {
"type": "string",
"description": "Possible Values: 'All', 'Deals', or 'Contacts'"
},
"title": {
"type": "string",
"description": "Title of the calendar feed"
},
"notification": {
"type": "boolean",
"description": "Whether or not this calendar has notifications"
}
}
}
}
}
FieldBulkCreateCustomAccountFieldValueRequest
{
"type": "object",
"properties": {
"array": {
"type": "object",
"required": [
"customerAccountId",
"customFieldId",
"fieldValue"
],
"properties": {
"fieldValue": {
"type": "string",
"description": "Values for the field. (For currency field only, this needs to be in cents: eg, 10050 = 100.5)"
},
"customFieldId": {
"type": "integer",
"format": "int32",
"description": "The ID of the custom field metum this field value relates to"
},
"fieldCurrency": {
"type": "string",
"description": "Currency code for the money value"
},
"customerAccountId": {
"type": "integer",
"format": "int32",
"description": "The ID of the account this field value relates to"
}
}
}
}
}
FieldBulkUpdateCustomFieldValueRequest
{
"type": "object",
"properties": {
"array": {
"type": "object",
"required": [
"id",
"fieldValue"
],
"properties": {
"id": {
"type": "integer",
"format": "int32",
"description": "ID of the dealCustomFieldData to update"
},
"fieldValue": {
"type": "string",
"description": "Values for the field. (For currency field only, this needs to be in cents: eg, 10050 = 100.5)"
},
"fieldCurrency": {
"type": "string",
"description": "Currency code for the money value"
}
}
}
}
}
FieldCreateCustomFieldMetaRequest
{
"type": "object",
"properties": {
"accountCustomFieldMetum": {
"type": "object",
"required": [
"fieldLabel",
"fieldType"
],
"properties": {
"fieldType": {
"type": "string",
"description": "Type of field. Possible values are: `text`, `textarea`, `date`, `datetime`, `dropdown`, `multiselect`, `radio`, `checkbox`, `hidden`, `currency`, or `number`."
},
"fieldLabel": {
"type": "string",
"description": "Name of the field"
},
"displayOrder": {
"type": "integer",
"format": "int32",
"description": "Order for displaying the field on Manage Fields page and deal profiles"
},
"fieldDefault": {
"type": "string",
"description": "Default value of the field"
},
"fieldOptions": {
"type": "array",
"items": {
"type": "string"
},
"description": "Options for the field. Only necessary if `field_type` is `dropdown`, `multiselect`, `radio`, or `checkbox`."
},
"isFormVisible": {
"type": "boolean",
"description": "Whether or not the field is visible on forms"
},
"fieldDefaultCurrency": {
"type": "string",
"description": "The 3-letter currency code of the default currency for the field. Only necessary if `field_type` is `currency`."
}
}
}
}
}
FieldCreateCustomFieldValueRequest
{
"type": "object",
"properties": {
"accountCustomFieldDatum": {
"type": "object",
"required": [
"customerAccountId",
"customFieldId",
"fieldValue"
],
"properties": {
"fieldValue": {
"type": "string",
"description": "Values for the field. (For `currency` field only, this needs to be in cents: eg, 10050 = 100.5)"
},
"customFieldId": {
"type": "integer",
"format": "int32",
"description": "The ID of the custom field metum this field value relates to"
},
"fieldCurrency": {
"type": "string",
"default": "Default Currency for Field",
"description": "Currency code for the money value"
},
"customerAccountId": {
"type": "integer",
"format": "int32",
"description": "The ID of the account this field value relates to"
}
}
}
}
}
FieldUpdateCustomFieldMetaRequest
{
"type": "object",
"properties": {
"accountCustomFieldMetum": {
"type": "object",
"required": [],
"properties": {
"fieldLabel": {
"type": "string",
"description": "Name of the field"
},
"displayOrder": {
"type": "integer",
"format": "int32",
"description": "Order for displaying the field on Manage Fields page and deal profiles"
},
"fieldDefault": {
"type": "string",
"description": "Default value of the field"
},
"fieldOptions": {
"type": "array",
"items": {
"type": "string"
},
"description": "Options for the field. Only necessary if field_type is dropdown, multiselect, radio, or checkbox."
},
"isFormVisible": {
"type": "boolean",
"description": "Whether or not the field is visible on forms"
}
}
}
}
}
FieldUpdateCustomFieldValueRequest
{
"type": "object",
"properties": {
"accountCustomFieldDatum": {
"type": "object",
"required": [],
"properties": {
"fieldValue": {
"type": "string",
"description": "Values for text"
},
"fieldCurrency": {
"type": "string",
"default": "Default Currency for Field",
"description": "Currency code for the `currency` value"
}
}
}
}
}
MessageCreateNewMessageRequest
{
"type": "object",
"properties": {
"message": {
"type": "object",
"required": [
"fromname",
"email",
"reply2"
],
"properties": {
"email": {
"type": "string",
"description": "Email of sender"
},
"reply2": {
"type": "string",
"description": "Reply email for the recipient to reply to"
},
"subject": {
"type": "string",
"description": "Subject of message"
},
"fromname": {
"type": "string",
"description": "Name of sender"
},
"preheader_text": {
"type": "string",
"description": "Preheader Text"
}
}
}
}
}
NoteCreateAccountNoteRequest
{
"type": "object",
"properties": {
"note": {
"type": "object",
"required": [
"note"
],
"properties": {
"note": {
"type": "string",
"description": "Account note's content"
}
}
}
}
}
NoteUpdateNoteRequest
{
"type": "object",
"properties": {
"note": {
"type": "object",
"required": [
"note"
],
"properties": {
"note": {
"type": "string",
"description": "Account note's content"
}
}
}
}
}