WildApricot Admin API — Emailing.Operations

naftiko: 1.0.0-alpha2
info:
  label: WildApricot Admin API — Emailing.Operations
  description: 'WildApricot Admin API — Emailing.Operations. 8 operations. Lead operation: WildApricot Get Count of Real Email
    Recipients (unique Addresses).. Self-contained Naftiko capability covering one Wildapricot business surface.'
  tags:
  - Wildapricot
  - Emailing.Operations
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    WILDAPRICOT_API_KEY: WILDAPRICOT_API_KEY
capability:
  consumes:
  - type: http
    namespace: admin-emailing-operations
    baseUri: https://api.wildapricot.org/v2.2
    description: WildApricot Admin API — Emailing.Operations business capability. Self-contained, no shared references.
    resources:
    - name: rpc-accountId-email-CountUniqueAddressesForEmailDraft
      path: /rpc/{accountId}/email/CountUniqueAddressesForEmailDraft
      operations:
      - name: getuniqueemailrecipientscountfordraft
        method: POST
        description: WildApricot Get Count of Real Email Recipients (unique Addresses).
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: rpc-accountId-email-CountUniqueAddressesForEmailRecipients
      path: /rpc/{accountId}/email/CountUniqueAddressesForEmailRecipients
      operations:
      - name: getuniqueemailrecipientscount
        method: POST
        description: WildApricot Get Count of Real Email Recipients (unique Addresses).
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: rpc-accountId-email-GetEmailDraftPreview
      path: /rpc/{accountId}/email/GetEmailDraftPreview
      operations:
      - name: getemaildraftpreview
        method: POST
        description: WildApricot Get Preview Version of Email.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: rpc-accountId-email-GetUniqueAddressesForEmailDraft
      path: /rpc/{accountId}/email/GetUniqueAddressesForEmailDraft
      operations:
      - name: getuniqueaddressesforemaildraft
        method: POST
        description: WildApricot Get Unique Addresses of Real Email Recipients.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: rpc-accountId-email-GetUniqueAddressesForEmailRecipients
      path: /rpc/{accountId}/email/GetUniqueAddressesForEmailRecipients
      operations:
      - name: getuniqueaddressesforemailrecipients
        method: POST
        description: WildApricot Get Unique Addresses of Real Email Recipients.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: rpc-accountId-email-SendEmail
      path: /rpc/{accountId}/email/SendEmail
      operations:
      - name: sendemail
        method: POST
        description: WildApricot Send Draft.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: rpc-accountId-email-SendEmailDraft
      path: /rpc/{accountId}/email/SendEmailDraft
      operations:
      - name: sendemaildraft
        method: POST
        description: WildApricot Send Draft.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: rpc-accountId-email-SetEmailDraftSchedule
      path: /rpc/{accountId}/email/SetEmailDraftSchedule
      operations:
      - name: setemaildraftschedule
        method: POST
        description: WildApricot Pause or Resume Scheduled Draft.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    authentication:
      type: bearer
      token: '{{env.WILDAPRICOT_API_KEY}}'
  exposes:
  - type: rest
    namespace: admin-emailing-operations-rest
    port: 8080
    description: REST adapter for WildApricot Admin API — Emailing.Operations. One Spectral-compliant resource per consumed
      operation, prefixed with /v1.
    resources:
    - path: /v1/rpc/{accountid}/email/countuniqueaddressesforemaildraft
      name: rpc-accountid-email-countuniqueaddressesforemaildraft
      description: REST surface for rpc-accountId-email-CountUniqueAddressesForEmailDraft.
      operations:
      - method: POST
        name: getuniqueemailrecipientscountfordraft
        description: WildApricot Get Count of Real Email Recipients (unique Addresses).
        call: admin-emailing-operations.getuniqueemailrecipientscountfordraft
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/rpc/{accountid}/email/countuniqueaddressesforemailrecipients
      name: rpc-accountid-email-countuniqueaddressesforemailrecipients
      description: REST surface for rpc-accountId-email-CountUniqueAddressesForEmailRecipients.
      operations:
      - method: POST
        name: getuniqueemailrecipientscount
        description: WildApricot Get Count of Real Email Recipients (unique Addresses).
        call: admin-emailing-operations.getuniqueemailrecipientscount
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/rpc/{accountid}/email/getemaildraftpreview
      name: rpc-accountid-email-getemaildraftpreview
      description: REST surface for rpc-accountId-email-GetEmailDraftPreview.
      operations:
      - method: POST
        name: getemaildraftpreview
        description: WildApricot Get Preview Version of Email.
        call: admin-emailing-operations.getemaildraftpreview
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/rpc/{accountid}/email/getuniqueaddressesforemaildraft
      name: rpc-accountid-email-getuniqueaddressesforemaildraft
      description: REST surface for rpc-accountId-email-GetUniqueAddressesForEmailDraft.
      operations:
      - method: POST
        name: getuniqueaddressesforemaildraft
        description: WildApricot Get Unique Addresses of Real Email Recipients.
        call: admin-emailing-operations.getuniqueaddressesforemaildraft
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/rpc/{accountid}/email/getuniqueaddressesforemailrecipients
      name: rpc-accountid-email-getuniqueaddressesforemailrecipients
      description: REST surface for rpc-accountId-email-GetUniqueAddressesForEmailRecipients.
      operations:
      - method: POST
        name: getuniqueaddressesforemailrecipients
        description: WildApricot Get Unique Addresses of Real Email Recipients.
        call: admin-emailing-operations.getuniqueaddressesforemailrecipients
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/rpc/{accountid}/email/sendemail
      name: rpc-accountid-email-sendemail
      description: REST surface for rpc-accountId-email-SendEmail.
      operations:
      - method: POST
        name: sendemail
        description: WildApricot Send Draft.
        call: admin-emailing-operations.sendemail
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/rpc/{accountid}/email/sendemaildraft
      name: rpc-accountid-email-sendemaildraft
      description: REST surface for rpc-accountId-email-SendEmailDraft.
      operations:
      - method: POST
        name: sendemaildraft
        description: WildApricot Send Draft.
        call: admin-emailing-operations.sendemaildraft
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/rpc/{accountid}/email/setemaildraftschedule
      name: rpc-accountid-email-setemaildraftschedule
      description: REST surface for rpc-accountId-email-SetEmailDraftSchedule.
      operations:
      - method: POST
        name: setemaildraftschedule
        description: WildApricot Pause or Resume Scheduled Draft.
        call: admin-emailing-operations.setemaildraftschedule
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: admin-emailing-operations-mcp
    port: 9090
    transport: http
    description: MCP adapter for WildApricot Admin API — Emailing.Operations. One tool per consumed operation, routed inline
      through this capability's consumes block.
    tools:
    - name: wildapricot-get-count-real-email
      description: WildApricot Get Count of Real Email Recipients (unique Addresses).
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: admin-emailing-operations.getuniqueemailrecipientscountfordraft
      outputParameters:
      - type: object
        mapping: $.
    - name: wildapricot-get-count-real-email-2
      description: WildApricot Get Count of Real Email Recipients (unique Addresses).
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: admin-emailing-operations.getuniqueemailrecipientscount
      outputParameters:
      - type: object
        mapping: $.
    - name: wildapricot-get-preview-version-email
      description: WildApricot Get Preview Version of Email.
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: admin-emailing-operations.getemaildraftpreview
      outputParameters:
      - type: object
        mapping: $.
    - name: wildapricot-get-unique-addresses-real
      description: WildApricot Get Unique Addresses of Real Email Recipients.
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: admin-emailing-operations.getuniqueaddressesforemaildraft
      outputParameters:
      - type: object
        mapping: $.
    - name: wildapricot-get-unique-addresses-real-2
      description: WildApricot Get Unique Addresses of Real Email Recipients.
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: admin-emailing-operations.getuniqueaddressesforemailrecipients
      outputParameters:
      - type: object
        mapping: $.
    - name: wildapricot-send-draft
      description: WildApricot Send Draft.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: admin-emailing-operations.sendemail
      outputParameters:
      - type: object
        mapping: $.
    - name: wildapricot-send-draft-2
      description: WildApricot Send Draft.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: admin-emailing-operations.sendemaildraft
      outputParameters:
      - type: object
        mapping: $.
    - name: wildapricot-pause-resume-scheduled-draft
      description: WildApricot Pause or Resume Scheduled Draft.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: admin-emailing-operations.setemaildraftschedule
      outputParameters:
      - type: object
        mapping: $.