ActiveCampaign Addresses API

The Addresses API from ActiveCampaign — 4 operation(s) for addresses.

Operations 7

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 /addresses Add a sender address · ActiveCampaign Create an Address #
Ask an LLM
“How do I add a new company postal address for my emails?”
“Can I save a second office address for compliance footers?”
Tell an agent
Create an address with {address}.
Add our London office as a sender address.
GET /addresses List mailing addresses · ActiveCampaign List All Addresses #
Ask an LLM
“Which physical sender addresses are saved in my ActiveCampaign account?”
“What postal addresses can I use in email footers?”
Tell an agent
List all my saved addresses.
Show every sender address on the account.
GET /addresses/{id} Get a sender address · ActiveCampaign Retrieve an Address #
Ask an LLM
“Where can I view one saved address by its ID?”
“What are the details of address 4?”
Tell an agent
Show address {id}.
Get the street and city of address {id}.
PUT /addresses/{id} Update a sender address · ActiveCampaign Update an Address #
Ask an LLM
“Can I change the details of an address after our office moved?”
“Is it possible to edit a saved address?”
Tell an agent
Update address {id} with {address}.
Change the street on address {id}.
DELETE /addresses/{id} Delete a sender address · ActiveCampaign Delete an Address #
Ask an LLM
“How do I remove an address we no longer use?”
“Can a saved sender address be deleted entirely?”
Tell an agent destructive · confirm first
Delete address {id}.
Remove the old office address {id}.
DELETE /addressGroups/{id} Unlink an address from a user group · ActiveCampaign Delete Address Associated with a Specific User Group #
Ask an LLM
“Can I detach an address from a specific user group without deleting it?”
“What removes the association between an address and a group?”
Tell an agent destructive · confirm first
Delete address-group association {id}.
Unlink the address from its user group via association {id}.
DELETE /addressLists/{id} Unlink an address from a list · ActiveCampaign Delete Address Associated with a Specific List #
Ask an LLM
“Is it possible to stop a list from using a particular address?”
“Which call removes an address's association with a list?”
Tell an agent destructive · confirm first
Delete address-list association {id}.
Detach the address from its list via association {id}.

Documentation

Specifications

Schemas & Data

Other Resources

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/activecampaign-addresses-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

activecampaign-addresses-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: ActiveCampaign API v3 Addresses API
  version: '3'
  description: The primary REST API for ActiveCampaign, organized around resources such as contacts, deals, accounts, automations, campaigns, messages, lists, tags, webhooks, custom objects, and ecommerce entities.
  x-generated-from: documentation
  contact:
    name: ActiveCampaign Support
    url: https://www.activecampaign.com
  license:
    name: Proprietary
servers:
- url: https://{yourAccountName}.api-us1.com/api/3
  description: ActiveCampaign API server (account-specific)
  variables:
    yourAccountName:
      default: yourAccountName
      description: Your ActiveCampaign account name
security:
- ApiToken: []
tags:
- name: Addresses
paths:
  /addresses:
    post:
      summary: ActiveCampaign Create an Address
      description: ''
      operationId: create-an-address
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                address:
                  properties:
                    groupid:
                      type: integer
                      format: int32
                    global:
                      type: string
                    company_name:
                      type: string
                    address_1:
                      type: string
                    address_2:
                      type: string
                    city:
                      type: string
                    state:
                      type: string
                    zip:
                      type: string
                    district:
                      type: string
                      description: (Optional for countries that use it)
                    country:
                      type: string
                      description: Accepts a (2) two character string - country code (eg 'US', 'CA', 'MX')
                    allgroup:
                      type: integer
                      format: int32
                    is_default:
                      type: boolean
                      description: Indicates default address
                  required:
                  - company_name
                  - address_1
                  - country
                  type: object
            examples:
              Request Example:
                value:
                  address:
                    company_name: TEST NAME
                    address_1: TEST ADDRESS
                    country: US
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Result:
                  value: "{\n    \"address\": {\n        \"companyName\": \"TEST NAME\",\n        \"address1\": \"TEST ADDRESS\",\n        \"country\": 3,\n        \"links\": {\n            \"addressGroup\": \"https://:account.api-us1.com/api/3/addresses/3/addressGroup\",\n            \"addressList\": \"https://:account.api-us1.com/api/3/addresses/3/addressList\",\n            \"forms\": \"https://:account.api-us1.com/api/3/addresses/3/forms\"\n        },\n        \"id\": \"3\"\n    }\n}"
              schema:
                type: object
                properties:
                  address:
                    type: object
                    properties:
                      companyName:
                        type: string
                        example: TEST NAME
                      address1:
                        type: string
                        example: TEST ADDRESS
                      country:
                        type: integer
                        example: 3
                        default: 0
                      links:
                        type: object
                        properties:
                          addressGroup:
                            type: string
                            example: https://:account.api-us1.com/api/3/addresses/3/addressGroup
                          addressList:
                            type: string
                            example: https://:account.api-us1.com/api/3/addresses/3/addressList
                          forms:
                            type: string
                            example: https://:account.api-us1.com/api/3/addresses/3/forms
                      id:
                        type: string
                        example: '3'
        '400':
          description: '400'
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                type: object
                properties: {}
      deprecated: false
      tags:
      - Addresses
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    get:
      summary: ActiveCampaign List All Addresses
      description: ''
      operationId: list-all-addresses
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                GET /addresses (Example RESPONSE):
                  value: "{\n    \"addresses\": [\n        {\n            \"companyName\": \"Test Company Name\",\n            \"address1\": \"Test Address\",\n            \"address2\": \"\",\n            \"city\": \"\",\n            \"state\": \"\",\n            \"district\": \"\",\n            \"zip\": \"\",\n            \"country\": \"US\",\n            \"allgroup\": \"0\",\n            \"isDefault\": \"1\",\n            \"links\": {\n                \"addressGroup\": \"https://:account.api-us1.com/api/3/addresses/1/addressGroup\",\n                \"addressList\": \"https://:account.api-us1.com/api/3/addresses/1/addressList\",\n                \"forms\": \"https://:account.api-us1.com/api/3/addresses/1/forms\"\n            },\n            \"id\": \"1\"\n        },\n        {\n            \"companyName\": \"TEST NAME\",\n            \"address1\": \"TEST ADDRESS\",\n            \"address2\": \"\",\n            \"city\": \"\",\n            \"state\": \"\",\n            \"district\": \"\",\n            \"zip\": \"\",\n            \"country\": \"US\",\n            \"allgroup\": \"0\",\n            \"isDefault\": \"0\",\n            \"links\": {\n                \"addressGroup\": \"https://:account.api-us1.com/api/3/addresses/2/addressGroup\",\n                \"addressList\": \"https://:account.api-us1.com/api/3/addresses/2/addressList\",\n                \"forms\": \"https://:account.api-us1.com/api/3/addresses/2/forms\"\n            },\n            \"id\": \"2\"\n        }\n    ],\n    \"meta\": {\n        \"total\": \"2\"\n    }\n}"
              schema:
                type: object
                properties:
                  addresses:
                    type: array
                    items:
                      type: object
                      properties:
                        companyName:
                          type: string
                          example: Test Company Name
                        address1:
                          type: string
                          example: Test Address
                        address2:
                          type: string
                          example: ''
                        city:
                          type: string
                          example: ''
                        state:
                          type: string
                          example: ''
                        district:
                          type: string
                          example: ''
                        zip:
                          type: string
                          example: ''
                        country:
                          type: string
                          example: US
                        allgroup:
                          type: string
                          example: '0'
                        isDefault:
                          type: string
                          example: '1'
                        links:
                          type: object
                          properties:
                            addressGroup:
                              type: string
                              example: https://:account.api-us1.com/api/3/addresses/1/addressGroup
                            addressList:
                              type: string
                              example: https://:account.api-us1.com/api/3/addresses/1/addressList
                            forms:
                              type: string
                              example: https://:account.api-us1.com/api/3/addresses/1/forms
                        id:
                          type: string
                          example: '1'
                  meta:
                    type: object
                    properties:
                      total:
                        type: string
                        example: '2'
        '400':
          description: '400'
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                type: object
                properties: {}
      deprecated: false
      tags:
      - Addresses
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /addresses/{id}:
    get:
      summary: ActiveCampaign Retrieve an Address
      description: ''
      operationId: retrieve-an-address
      parameters:
      - name: id
        in: path
        description: ID of the Address to retrieve
        schema:
          type: integer
          format: int32
        required: true
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Result:
                  value: "{\n    \"address\": {\n        \"companyName\": \"Test Company Name\",\n        \"address1\": \"Test Address\",\n        \"address2\": \"\",\n        \"city\": \"\",\n        \"state\": \"\",\n        \"district\": \"\",\n        \"zip\": \"\",\n        \"country\": \"US\",\n        \"allgroup\": \"0\",\n        \"isDefault\": \"1\",\n        \"links\": {\n            \"addressGroup\": \"https://:account.api-us1.com/api/3/addresses/1/addressGroup\",\n            \"addressList\": \"https://:account.api-us1.com/api/3/addresses/1/addressList\",\n            \"forms\": \"https://:account.api-us1.com/api/3/addresses/1/forms\"\n        },\n        \"id\": \"1\"\n    }\n}"
              schema:
                type: object
                properties:
                  address:
                    type: object
                    properties:
                      companyName:
                        type: string
                        example: Test Company Name
                      address1:
                        type: string
                        example: Test Address
                      address2:
                        type: string
                        example: ''
                      city:
                        type: string
                        example: ''
                      state:
                        type: string
                        example: ''
                      district:
                        type: string
                        example: ''
                      zip:
                        type: string
                        example: ''
                      country:
                        type: string
                        example: US
                      allgroup:
                        type: string
                        example: '0'
                      isDefault:
                        type: string
                        example: '1'
                      links:
                        type: object
                        properties:
                          addressGroup:
                            type: string
                            example: https://:account.api-us1.com/api/3/addresses/1/addressGroup
                          addressList:
                            type: string
                            example: https://:account.api-us1.com/api/3/addresses/1/addressList
                          forms:
                            type: string
                            example: https://:account.api-us1.com/api/3/addresses/1/forms
                      id:
                        type: string
                        example: '1'
        '400':
          description: '400'
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                type: object
                properties: {}
      deprecated: false
      tags:
      - Addresses
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    put:
      summary: ActiveCampaign Update an Address
      description: ''
      operationId: update-an-address
      parameters:
      - name: id
        in: path
        description: ID of the Address being changed
        schema:
          type: integer
          format: int32
        required: true
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                address:
                  properties:
                    groupid:
                      type: integer
                      format: int32
                    global:
                      type: string
                    company_name:
                      type: string
                    address_1:
                      type: string
                    address_2:
                      type: string
                    city:
                      type: string
                    state:
                      type: string
                    zip:
                      type: string
                    district:
                      type: string
                      description: (Optional for countries that use it)
                    country:
                      type: string
                      description: Accepts a (2) two character string - country code (eg 'US', 'CA', 'MX')
                    allgroup:
                      type: integer
                      format: int32
                    is_default:
                      type: boolean
                      description: Indicates default address
                  required:
                  - company_name
                  - address_1
                  - country
                  type: object
            examples:
              Request Example:
                value:
                  address:
                    companyName: New Test Company Name
                    address1: 111 New Test Address
                    address2: ''
                    city: New Test City
                    state: Florida
                    zip: '12345'
                    country: US
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Result:
                  value: "{\n    \"address\": {\n        \"companyName\": \"New Test Company Name\",\n        \"address1\": \"111 New Test Address\",\n        \"address2\": \"\",\n        \"city\": \"New Test City\",\n        \"state\": \"Florida\",\n        \"district\": \"\",\n        \"zip\": \"12345\",\n        \"country\": \"US\",\n        \"allgroup\": \"0\",\n        \"isDefault\": \"1\",\n        \"links\": {\n            \"addressGroup\": \"https://:account.api-us1.com/api/3/addresses/1/addressGroup\",\n            \"addressList\": \"https://:account.api-us1.com/api/3/addresses/1/addressList\",\n            \"forms\": \"https://:account.api-us1.com/api/3/addresses/1/forms\"\n        },\n        \"id\": \"1\"\n    }\n}"
              schema:
                type: object
                properties:
                  address:
                    type: object
                    properties:
                      companyName:
                        type: string
                        example: New Test Company Name
                      address1:
                        type: string
                        example: 111 New Test Address
                      address2:
                        type: string
                        example: ''
                      city:
                        type: string
                        example: New Test City
                      state:
                        type: string
                        example: Florida
                      district:
                        type: string
                        example: ''
                      zip:
                        type: string
                        example: '12345'
                      country:
                        type: string
                        example: US
                      allgroup:
                        type: string
                        example: '0'
                      isDefault:
                        type: string
                        example: '1'
                      links:
                        type: object
                        properties:
                          addressGroup:
                            type: string
                            example: https://:account.api-us1.com/api/3/addresses/1/addressGroup
                          addressList:
                            type: string
                            example: https://:account.api-us1.com/api/3/addresses/1/addressList
                          forms:
                            type: string
                            example: https://:account.api-us1.com/api/3/addresses/1/forms
                      id:
                        type: string
                        example: '1'
        '404':
          description: '404'
          content:
            application/json:
              examples:
                Result:
                  value: "{\n    \"message\": \"No Result found for Address with id 3\"\n}"
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: No Result found for Address with id 3
      deprecated: false
      tags:
      - Addresses
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    delete:
      summary: ActiveCampaign Delete an Address
      description: ''
      operationId: delete-an-address
      parameters:
      - name: id
        in: path
        description: ID of the Address to delete
        schema:
          type: integer
          format: int32
        required: true
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                type: object
                properties: {}
        '404':
          description: '404'
          content:
            application/json:
              examples:
                Result:
                  value: "{\n    \"message\": \"No Result found for Address with id 3\"\n}"
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: No Result found for Address with id 3
      deprecated: false
      tags:
      - Addresses
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /addressGroups/{id}:
    delete:
      summary: ActiveCampaign Delete Address Associated with a Specific User Group
      description: ''
      operationId: delete-an-addressgroup
      parameters:
      - name: id
        in: path
        description: ID of the AddressGroup to delete
        schema:
          type: integer
          format: int32
        required: true
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                type: object
                properties: {}
        '404':
          description: '404'
          content:
            application/json:
              examples:
                Result:
                  value: "{\n    \"message\": \"No Result found for AddressGroup with id 19\"\n}"
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: No Result found for AddressGroup with id 19
      deprecated: false
      tags:
      - Addresses
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /addressLists/{id}:
    delete:
      summary: ActiveCampaign Delete Address Associated with a Specific List
      description: ''
      operationId: delete-an-addresslist
      parameters:
      - name: id
        in: path
        description: ID of the AddressList to delete
        schema:
          type: integer
          format: int32
        required: true
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                type: object
                properties: {}
        '404':
          description: '404'
          content:
            application/json:
              examples:
                Result:
                  value: "{\n    \"message\": \"No Result found for AddressList with id 6\"\n}"
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: No Result found for AddressList with id 6
      deprecated: false
      tags:
      - Addresses
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
components:
  securitySchemes:
    sec0:
      type: apiKey
      name: Api-Token
      in: header
      x-default: ''
    ApiToken:
      type: apiKey
      in: header
      name: Api-Token
      description: Your ActiveCampaign API token found in account settings under Developer tab
x-readme:
  headers: []
  explorer-enabled: false
  proxy-enabled: false
x-readme-fauxas: true