Query structured spec data via REST or MCP. Get exactly what your agent needs.
https://{youraccountname}.api-us1.com/api/3
/accountContacts/{id}
Delete an existing account association
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| id | path | required | integer | Association’s ID |
200
404
DELETE /accountContacts/{id}
/accounts/bulk_delete
Delete an existing account
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| []ids | query | optional | integer | An integer id of the account to be deleted |
| []ids | query | optional | integer | An integer id of the account to be deleted |
| []ids | query | optional | integer | An integer id of the account to be deleted |
200
400
DELETE /accounts/bulk_delete
/accounts/{id}
Delete an existing account
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| id | path | required | integer | Account’s id |
200
400
DELETE /accounts/{id}
/addresses/{id}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| id | path | required | integer | ID of the Address to delete |
200
404
DELETE /addresses/{id}
/calendars/{id}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| id | path | required | integer | ID of the calendar feed to delete |
200
DELETE /calendars/{id}
/connections/{id}
Delete an existing connection resource.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| id | path | required | string | The id of the connection to delete. |
200
400
DELETE /connections/{id}
/contactAutomations/{id}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| id | path | required | integer | ID of the contactAutomation to delete |
200
403
DELETE /contactAutomations/{id}
/contacts/{id}
Delete an existing contact
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| id | path | required | integer | The contact id |
200
404
DELETE /contacts/{id}
/ecomCustomers/{id}
Delete an existing e-commerce customer resource.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| id | path | required | string | The id of the customer to delete. |
200
400
DELETE /ecomCustomers/{id}
/contactDeals/{id}
Delete an existing secondary contact
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| id | path | required | integer | Secondary Contact’s id |
200
404
DELETE /contactDeals/{id}
/dealCustomFieldData/{id}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| id | path | required | integer | ID of the dealCustomFieldData to retrieve |
200
404
DELETE /dealCustomFieldData/{id}
/dealCustomFieldMeta/{id}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| id | path | required | integer | ID of the field to delete |
200
404
DELETE /dealCustomFieldMeta/{id}
/dealGroups/{id}
Delete an existing pipeline
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| id | path | required | integer | Pipeline’s id |
200
DELETE /dealGroups/{id}
/dealRoles/{id}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| id | path | required | string | Deal role’s id |
200
400
DELETE /dealRoles/{id}
/dealStages/{id}
Delete an existing stage
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| id | path | required | integer | Deal stage’s id |
200
DELETE /dealStages/{id}
/dealTasks/{id}
Delete an existing task
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| id | path | required | integer | The task id |
200
400
DELETE /dealTasks/{id}
/dealTasktypes/{id}
Delete an existing task type
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| id | path | required | integer | Deal task type’s id |
403
DELETE /dealTasktypes/{id}
/deals/{id}
Delete an existing deal
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| id | path | required | integer | The Deal’s id |
200
400
DELETE /deals/{id}
/eventTrackingEvents/{eventName}
Remove an existing event tracking event (name only)
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| eventName | path | required | string | Name of event to delete. Spaces in names are allowed, but must be encoded (for example, “my%20event”). |
200
400
DELETE /eventTrackingEvents/{eventName}
/accountCustomFieldData/{id}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| id | path | required | integer | ID of the dealCustomFieldData to retrieve |
200
404
DELETE /accountCustomFieldData/{id}
/accountCustomFieldMeta/{id}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| id | path | required | integer | ID of the field to delete |
200
404
DELETE /accountCustomFieldMeta/{id}
/customObjects/schemas/{schemaId}/fields/{fieldId}
Deleting a schema field is an irreversible process.
Assuming a valid 202 Accepted response is received, any associated field data on associated records will immediately be unavailable to the user. There may be a small delay if record requests are in the midst of processing when the field delete request is issued.
The deleted field id will not be immediately recycled for reuse. Users are encouraged to leverage the ?showFields=all query parameter when programmatically creating new schema fields, to ensure field id uniqueness. Fields that have been deleted will contain a status: marked_for_deletion attribute.
The field delete operation is only permitted for admin users.
Field deletion is not permitted on public or child schemas (private schemas only).
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| schemaId | path | required | string | Schema ID of the field to be deleted |
| fieldId | path | required | string | Field ID of the field to be deleted |
| showFields | query | optional | string | Toggle which fields are shown in the response body of a schema (if there hidden due to e.g. recently being deleted). Omit this parameter entirely to hide fields by default. |
202
DELETE /customObjects/schemas/{schemaId}/fields/{fieldId}
/fieldValues/{id}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| id | path | required | integer | ID of the fieldValue to delete |
200
403
DELETE /fieldValues/{id}
/fields/{id}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| id | path | required | integer | ID of the field option to delete |
200
404
DELETE /fields/{id}
/groupMembers/{groupID}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| groupID | path | required | string | Group ID |
application/json
FieldDeleteFieldGroupRequest
200
404
DELETE /groupMembers/{groupID}
/groups/{id}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| id | path | required | integer | ID of the group to be deleted |
200
400
DELETE /groups/{id}
/addressLists/{id}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| id | path | required | integer | ID of the AddressList to delete |
200
404
DELETE /addressLists/{id}
/fieldRels/{fieldRelId}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| fieldRelId | path | required | integer | Field relationship ID to be deleted |
200
403
DELETE /fieldRels/{fieldRelId}
/lists/{id}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| id | path | required | integer | ID of the list to delete |
200
403
DELETE /lists/{id}
/siteTrackingDomains/{name}
Remove a domain from the site tracking whitelist
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| name | path | required | string | The domain name to remove from the whitelist |
204
DELETE /siteTrackingDomains/{name}
/messages/{id}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| id | path | required | string | ID of the message to delete |
200
400
DELETE /messages/{id}
/notes/{id}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| id | path | required | string | ID of the note to delete |
200
403
DELETE /notes/{id}
/ecomOrders/{ecomOrderId}
Delete an existing e-commerce order resource.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| ecomOrderId | path | required | integer | The id of the order to delete. |
200
DELETE /ecomOrders/{ecomOrderId}
/taskOutccomes/{id}
Delete an existing task outcome
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| id | path | required | string | Task outcome’s id |
200
404
DELETE /taskOutccomes/{id}
/tasktypeOutcomeRels/{id}
Delete an existing task type - outcome relation
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| id | path | required | integer | Task type - outcome relation’s id |
200
404
DELETE /tasktypeOutcomeRels/{id}
/savedResponses/{id}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| id | path | required | integer | ID of the saved response to remove |
200
404
DELETE /savedResponses/{id}
/customObjects/records/{schemaId}/external/{externalId}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| schemaId | path | required | string | ID of schema |
| externalId | path | required | string | External ID of record |
202
400
DELETE /customObjects/records/{schemaId}/external/{externalId}
/customObjects/records/{schemaId}/{recordId}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| schemaId | path | required | string | ID of schema |
| recordId | path | required | string | ID of record |
202
400
DELETE /customObjects/records/{schemaId}/{recordId}
/customObjects/schemas/{id}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| id | path | required | string | Id of schema to delete |
200
404
DELETE /customObjects/schemas/{id}
/contactTags/{id}
Delete a contact tag object
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| id | path | required | integer | The contactTag id |
200
404
DELETE /contactTags/{id}
/tags/{id}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| id | path | required | integer | ID of the tag to remove |
200
404
DELETE /tags/{id}
/addressGroups/{id}
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| id | path | required | integer | ID of the AddressGroup to delete |
200
404
DELETE /addressGroups/{id}
/users/{id}
Delete an existing user
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| id | path | required | integer | ID of the user you wish to delete |
200
400
DELETE /users/{id}
/webhooks/{id}
Delete an existing webhook
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| id | path | required | integer | The webhook id |
200
DELETE /webhooks/{id}
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"
}
}
}
}
}