openapi: 3.1.0
info:
  title: ActiveCampaign Broadcasts Contacts API
  version: '3'
  description: ActiveCampaign's REST API (version 3) for marketing automation, CRM, sales pipelines, and customer engagement. Covers contacts, lists, deals, campaigns, segments, custom fields, variables, broadcasts, and bulk operations. Authentication is via an account-specific API key supplied in the `Api-Token` header (the developer portal also references `X-Auth-Token`).
  contact:
    name: ActiveCampaign Developers
    url: https://developers.activecampaign.com
servers:
- url: https://{account}.api-us1.com
  description: Account-scoped ActiveCampaign API server
  variables:
    account:
      default: example
      description: Your ActiveCampaign account subdomain
security:
- ApiKeyAuth: []
tags:
- name: Contacts
paths:
  /api/3/contacts:
    get:
      summary: List, search, and filter contacts
      tags:
      - Contacts
    post:
      summary: Create a contact
      tags:
      - Contacts
  /api/3/contacts/{contactID}:
    put:
      summary: Sync (update) a contact
      tags:
      - Contacts
  /api/3/contacts/{contactID}/activities:
    get:
      summary: View recent activity for a contact
      tags:
      - Contacts
  /api/3/contacts/{contactID}/geoips:
    get:
      summary: Retrieve a contact's geo-IP list
      tags:
      - Contacts
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: Api-Token