Automattic

Automattic Agency API

The agency API from Automattic — 88 operation(s) for agency.

GitHub OpenAPI

Operations 120

GET /wpcom/v2/agency GET /wpcom/v2/agency #
POST /wpcom/v2/agency POST /wpcom/v2/agency #
GET /wpcom/v2/agency/blog/{blog_id} GET /wpcom/v2/agency/blog/{blog_id} #
GET /wpcom/v2/agency/embeds/tipalti GET /wpcom/v2/agency/embeds/tipalti #
GET /wpcom/v2/agency/exists/name GET /wpcom/v2/agency/exists/name #
GET /wpcom/v2/agency/exists/url GET /wpcom/v2/agency/exists/url #
POST /wpcom/v2/agency/help/pressable/support POST /wpcom/v2/agency/help/pressable/support #
POST /wpcom/v2/agency/help/zendesk/create-ticket POST /wpcom/v2/agency/help/zendesk/create-ticket #
POST /wpcom/v2/agency/hire-an-expert POST /wpcom/v2/agency/hire-an-expert #
POST /wpcom/v2/agency/hubspot/webhook POST /wpcom/v2/agency/hubspot/webhook #
POST /wpcom/v2/agency/lead-matching/client POST /wpcom/v2/agency/lead-matching/client #
DELETE /wpcom/v2/agency/license DELETE /wpcom/v2/agency/license #
GET /wpcom/v2/agency/license/dev-site GET /wpcom/v2/agency/license/dev-site #
GET /wpcom/v2/agency/partner-directory GET /wpcom/v2/agency/partner-directory #
POST /wpcom/v2/agency/partner-directory/form-submission POST /wpcom/v2/agency/partner-directory/form-submission #
GET /wpcom/v2/agency/partner-directory/{agency_id} GET /wpcom/v2/agency/partner-directory/{agency_id} #
POST /wpcom/v2/agency/pressable/new-account POST /wpcom/v2/agency/pressable/new-account #
POST /wpcom/v2/agency/pressable/premium-plan-referral POST /wpcom/v2/agency/pressable/premium-plan-referral #
GET /wpcom/v2/agency/products GET /wpcom/v2/agency/products #
GET /wpcom/v2/agency/resources GET /wpcom/v2/agency/resources #
POST /wpcom/v2/agency/resources/record-event POST /wpcom/v2/agency/resources/record-event #
POST /wpcom/v2/agency/signup POST /wpcom/v2/agency/signup #
GET /wpcom/v2/agency/signup-context GET /wpcom/v2/agency/signup-context #
POST /wpcom/v2/agency/signup/contact-support POST /wpcom/v2/agency/signup/contact-support #
POST /wpcom/v2/agency/user-feedback POST /wpcom/v2/agency/user-feedback #
GET /wpcom/v2/agency/validate/{field} GET /wpcom/v2/agency/validate/{field} #
POST /wpcom/v2/agency/vip/partner-opportunity POST /wpcom/v2/agency/vip/partner-opportunity #
PUT /wpcom/v2/agency/{agency_id} PUT /wpcom/v2/agency/{agency_id} #
GET /wpcom/v2/agency/{agency_id}/a4a-mcp/settings GET /wpcom/v2/agency/{agency_id}/a4a-mcp/settings #
POST /wpcom/v2/agency/{agency_id}/a4a-mcp/settings POST /wpcom/v2/agency/{agency_id}/a4a-mcp/settings #
GET /wpcom/v2/agency/{agency_id}/a4a/collateral/{post_id} GET /wpcom/v2/agency/{agency_id}/a4a/collateral/{post_id} #
GET /wpcom/v2/agency/{agency_id}/a4a/collateral/{post_id}/html GET /wpcom/v2/agency/{agency_id}/a4a/collateral/{post_id}/html #
GET /wpcom/v2/agency/{agency_id}/a4a/collateral/{post_id}/pdf GET /wpcom/v2/agency/{agency_id}/a4a/collateral/{post_id}/pdf #
POST /wpcom/v2/agency/{agency_id}/a4a/collateral/{post_id}/social/{direction_id}/{size}/png POST /wpcom/v2/agency/{agency_id}/a4a/collateral/{post_id}/social/{direction_id}/{size}/png #
POST /wpcom/v2/agency/{agency_id}/a4a/collaterals/{collateral_id}/refine POST /wpcom/v2/agency/{agency_id}/a4a/collaterals/{collateral_id}/refine #
GET /wpcom/v2/agency/{agency_id}/a4a/outputs GET /wpcom/v2/agency/{agency_id}/a4a/outputs #
GET /wpcom/v2/agency/{agency_id}/a4a/projects GET /wpcom/v2/agency/{agency_id}/a4a/projects #
POST /wpcom/v2/agency/{agency_id}/a4a/projects POST /wpcom/v2/agency/{agency_id}/a4a/projects #
GET /wpcom/v2/agency/{agency_id}/a4a/projects/{project_id} GET /wpcom/v2/agency/{agency_id}/a4a/projects/{project_id} #
DELETE /wpcom/v2/agency/{agency_id}/a4a/projects/{project_id} DELETE /wpcom/v2/agency/{agency_id}/a4a/projects/{project_id} #
GET /wpcom/v2/agency/{agency_id}/a4a/projects/{project_id}/outputs GET /wpcom/v2/agency/{agency_id}/a4a/projects/{project_id}/outputs #
POST /wpcom/v2/agency/{agency_id}/a4a/runs POST /wpcom/v2/agency/{agency_id}/a4a/runs #
GET /wpcom/v2/agency/{agency_id}/a4a/runs/{run_id} GET /wpcom/v2/agency/{agency_id}/a4a/runs/{run_id} #
DELETE /wpcom/v2/agency/{agency_id}/a4a/runs/{run_id} DELETE /wpcom/v2/agency/{agency_id}/a4a/runs/{run_id} #
POST /wpcom/v2/agency/{agency_id}/amplify/reports POST /wpcom/v2/agency/{agency_id}/amplify/reports #
GET /wpcom/v2/agency/{agency_id}/amplify/reports GET /wpcom/v2/agency/{agency_id}/amplify/reports #
GET /wpcom/v2/agency/{agency_id}/amplify/reports/{report_id} GET /wpcom/v2/agency/{agency_id}/amplify/reports/{report_id} #
POST /wpcom/v2/agency/{agency_id}/amplify/reports/{report_id} POST /wpcom/v2/agency/{agency_id}/amplify/reports/{report_id} #
PUT /wpcom/v2/agency/{agency_id}/amplify/reports/{report_id} PUT /wpcom/v2/agency/{agency_id}/amplify/reports/{report_id} #
PATCH /wpcom/v2/agency/{agency_id}/amplify/reports/{report_id} PATCH /wpcom/v2/agency/{agency_id}/amplify/reports/{report_id} #
GET /wpcom/v2/agency/{agency_id}/benchmarks GET /wpcom/v2/agency/{agency_id}/benchmarks #
POST /wpcom/v2/agency/{agency_id}/benchmarks POST /wpcom/v2/agency/{agency_id}/benchmarks #
GET /wpcom/v2/agency/{agency_id}/benchmarks/aggregates GET /wpcom/v2/agency/{agency_id}/benchmarks/aggregates #
GET /wpcom/v2/agency/{agency_id}/benchmarks/config GET /wpcom/v2/agency/{agency_id}/benchmarks/config #
GET /wpcom/v2/agency/{agency_id}/benchmarks/peers GET /wpcom/v2/agency/{agency_id}/benchmarks/peers #
GET /wpcom/v2/agency/{agency_id}/benchmarks/{quarter}/{year} GET /wpcom/v2/agency/{agency_id}/benchmarks/{quarter}/{year} #
GET /wpcom/v2/agency/{agency_id}/clients GET /wpcom/v2/agency/{agency_id}/clients #
POST /wpcom/v2/agency/{agency_id}/clients POST /wpcom/v2/agency/{agency_id}/clients #
GET /wpcom/v2/agency/{agency_id}/clients/{client_id} GET /wpcom/v2/agency/{agency_id}/clients/{client_id} #
PUT /wpcom/v2/agency/{agency_id}/clients/{client_id} PUT /wpcom/v2/agency/{agency_id}/clients/{client_id} #
DELETE /wpcom/v2/agency/{agency_id}/clients/{client_id} DELETE /wpcom/v2/agency/{agency_id}/clients/{client_id} #
GET /wpcom/v2/agency/{agency_id}/lead-matching GET /wpcom/v2/agency/{agency_id}/lead-matching #
PUT /wpcom/v2/agency/{agency_id}/lead-matching PUT /wpcom/v2/agency/{agency_id}/lead-matching #
POST /wpcom/v2/agency/{agency_id}/media POST /wpcom/v2/agency/{agency_id}/media #
PUT /wpcom/v2/agency/{agency_id}/profile PUT /wpcom/v2/agency/{agency_id}/profile #
PUT /wpcom/v2/agency/{agency_id}/profile/application PUT /wpcom/v2/agency/{agency_id}/profile/application #
POST /wpcom/v2/agency/{agency_id}/referral-email-preview POST /wpcom/v2/agency/{agency_id}/referral-email-preview #
GET /wpcom/v2/agency/{agency_id}/referrals GET /wpcom/v2/agency/{agency_id}/referrals #
POST /wpcom/v2/agency/{agency_id}/referrals POST /wpcom/v2/agency/{agency_id}/referrals #
GET /wpcom/v2/agency/{agency_id}/referrals/commission-payout GET /wpcom/v2/agency/{agency_id}/referrals/commission-payout #
GET /wpcom/v2/agency/{agency_id}/referrals/invoices GET /wpcom/v2/agency/{agency_id}/referrals/invoices #
GET /wpcom/v2/agency/{agency_id}/referrals/{referral_id} GET /wpcom/v2/agency/{agency_id}/referrals/{referral_id} #
DELETE /wpcom/v2/agency/{agency_id}/referrals/{referral_id} DELETE /wpcom/v2/agency/{agency_id}/referrals/{referral_id} #
POST /wpcom/v2/agency/{agency_id}/referrals/{referral_id}/archive POST /wpcom/v2/agency/{agency_id}/referrals/{referral_id}/archive #
PUT /wpcom/v2/agency/{agency_id}/referrals/{referral_id}/archive PUT /wpcom/v2/agency/{agency_id}/referrals/{referral_id}/archive #
PATCH /wpcom/v2/agency/{agency_id}/referrals/{referral_id}/archive PATCH /wpcom/v2/agency/{agency_id}/referrals/{referral_id}/archive #
POST /wpcom/v2/agency/{agency_id}/referrals/{referral_id}/resend POST /wpcom/v2/agency/{agency_id}/referrals/{referral_id}/resend #
PUT /wpcom/v2/agency/{agency_id}/referrals/{referral_id}/resend PUT /wpcom/v2/agency/{agency_id}/referrals/{referral_id}/resend #
PATCH /wpcom/v2/agency/{agency_id}/referrals/{referral_id}/resend PATCH /wpcom/v2/agency/{agency_id}/referrals/{referral_id}/resend #
GET /wpcom/v2/agency/{agency_id}/reports GET /wpcom/v2/agency/{agency_id}/reports #
POST /wpcom/v2/agency/{agency_id}/reports POST /wpcom/v2/agency/{agency_id}/reports #
GET /wpcom/v2/agency/{agency_id}/reports/{report_id} GET /wpcom/v2/agency/{agency_id}/reports/{report_id} #
DELETE /wpcom/v2/agency/{agency_id}/reports/{report_id} DELETE /wpcom/v2/agency/{agency_id}/reports/{report_id} #
POST /wpcom/v2/agency/{agency_id}/reports/{report_id}/send POST /wpcom/v2/agency/{agency_id}/reports/{report_id}/send #
GET /wpcom/v2/agency/{agency_id}/sites GET /wpcom/v2/agency/{agency_id}/sites #
POST /wpcom/v2/agency/{agency_id}/sites POST /wpcom/v2/agency/{agency_id}/sites #
GET /wpcom/v2/agency/{agency_id}/sites/pending GET /wpcom/v2/agency/{agency_id}/sites/pending #
POST /wpcom/v2/agency/{agency_id}/sites/provision-dev-site POST /wpcom/v2/agency/{agency_id}/sites/provision-dev-site #
PUT /wpcom/v2/agency/{agency_id}/sites/tag-for-commission PUT /wpcom/v2/agency/{agency_id}/sites/tag-for-commission #
PUT /wpcom/v2/agency/{agency_id}/sites/tags PUT /wpcom/v2/agency/{agency_id}/sites/tags #
PUT /wpcom/v2/agency/{agency_id}/sites/{jetpack_site_id}/monitor PUT /wpcom/v2/agency/{agency_id}/sites/{jetpack_site_id}/monitor #
PUT /wpcom/v2/agency/{agency_id}/sites/{site_id} PUT /wpcom/v2/agency/{agency_id}/sites/{site_id} #
DELETE /wpcom/v2/agency/{agency_id}/sites/{site_id} DELETE /wpcom/v2/agency/{agency_id}/sites/{site_id} #
DELETE /wpcom/v2/agency/{agency_id}/sites/{site_id}/delete-dev-site DELETE /wpcom/v2/agency/{agency_id}/sites/{site_id}/delete-dev-site #
GET /wpcom/v2/agency/{agency_id}/sites/{site_id}/notes GET /wpcom/v2/agency/{agency_id}/sites/{site_id}/notes #
POST /wpcom/v2/agency/{agency_id}/sites/{site_id}/notes POST /wpcom/v2/agency/{agency_id}/sites/{site_id}/notes #
PUT /wpcom/v2/agency/{agency_id}/sites/{site_id}/notes/{note_id} PUT /wpcom/v2/agency/{agency_id}/sites/{site_id}/notes/{note_id} #
DELETE /wpcom/v2/agency/{agency_id}/sites/{site_id}/notes/{note_id} DELETE /wpcom/v2/agency/{agency_id}/sites/{site_id}/notes/{note_id} #
POST /wpcom/v2/agency/{agency_id}/sites/{site_id}/provision POST /wpcom/v2/agency/{agency_id}/sites/{site_id}/provision #
POST /wpcom/v2/agency/{agency_id}/sites/{site_id}/request-migration-reverification POST /wpcom/v2/agency/{agency_id}/sites/{site_id}/request-migration-reverification #
GET /wpcom/v2/agency/{agency_id}/sites/{site_id}/tags GET /wpcom/v2/agency/{agency_id}/sites/{site_id}/tags #
PUT /wpcom/v2/agency/{agency_id}/sites/{site_id}/tags PUT /wpcom/v2/agency/{agency_id}/sites/{site_id}/tags #
GET /wpcom/v2/agency/{agency_id}/tipalti GET /wpcom/v2/agency/{agency_id}/tipalti #
POST /wpcom/v2/agency/{agency_id}/transfer-ownership POST /wpcom/v2/agency/{agency_id}/transfer-ownership #
PUT /wpcom/v2/agency/{agency_id}/transfer-ownership PUT /wpcom/v2/agency/{agency_id}/transfer-ownership #
PATCH /wpcom/v2/agency/{agency_id}/transfer-ownership PATCH /wpcom/v2/agency/{agency_id}/transfer-ownership #
GET /wpcom/v2/agency/{agency_id}/user-invites GET /wpcom/v2/agency/{agency_id}/user-invites #
POST /wpcom/v2/agency/{agency_id}/user-invites POST /wpcom/v2/agency/{agency_id}/user-invites #
GET /wpcom/v2/agency/{agency_id}/user-invites/{invite_id} GET /wpcom/v2/agency/{agency_id}/user-invites/{invite_id} #
POST /wpcom/v2/agency/{agency_id}/user-invites/{invite_id} POST /wpcom/v2/agency/{agency_id}/user-invites/{invite_id} #
DELETE /wpcom/v2/agency/{agency_id}/user-invites/{invite_id} DELETE /wpcom/v2/agency/{agency_id}/user-invites/{invite_id} #
POST /wpcom/v2/agency/{agency_id}/user-invites/{invite_id}/resend POST /wpcom/v2/agency/{agency_id}/user-invites/{invite_id}/resend #
GET /wpcom/v2/agency/{agency_id}/users GET /wpcom/v2/agency/{agency_id}/users #
DELETE /wpcom/v2/agency/{agency_id}/users/{user_id} DELETE /wpcom/v2/agency/{agency_id}/users/{user_id} #
POST /wpcom/v2/agency/{agency_id}/validate-site-address POST /wpcom/v2/agency/{agency_id}/validate-site-address #
GET /wpcom/v2/agency/{agency_id}/woocommerce/woopayments GET /wpcom/v2/agency/{agency_id}/woocommerce/woopayments #
GET /wpcom/v2/agency/{agency_id}/woocommerce/woopayments/{blog_id} GET /wpcom/v2/agency/{agency_id}/woocommerce/woopayments/{blog_id} #
POST /wpcom/v2/agency/{customer_uid}/pressable/event POST /wpcom/v2/agency/{customer_uid}/pressable/event #
GET /wpcom/v2/agency/{customer_uid}/pressable/mrr GET /wpcom/v2/agency/{customer_uid}/pressable/mrr #

Documentation

📖
Documentation
https://developer.wordpress.com/docs/api/
📖
APIReference
https://developer.wordpress.com/docs/api/rest-api-reference/
📖
GettingStarted
https://developer.wordpress.com/docs/api/getting-started/
📖
Documentation
https://akismet.com/development/api/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/automattic/refs/heads/main/openapi/automattic-agency-api-openapi.yml

Other Resources

🔗
Console
https://developer.wordpress.com/docs/api/console/
🔗
SourceCode
https://github.com/Automattic/akismet-api
🔗
PluginManifest
https://raw.githubusercontent.com/api-evangelist/automattic/refs/heads/main/well-known/automattic-ai-plugin.json

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/automattic-agency-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.

GitHub Google LinkedIn

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

OpenAPI Specification

automattic-agency-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: WordPress.com REST API — wpcom/v2 namespace Agency API
  version: v2
  description: Derived by API Evangelist from the WordPress.com REST API route index published at https://public-api.wordpress.com/wpcom/v2/. Paths, HTTP methods, and parameter names/types/descriptions/defaults are taken verbatim from that index. Response schemas are not published in the route index, so successful responses are described but not schematised; the error envelope was observed live on public-api.wordpress.com.
  contact:
    name: Automattic
    url: https://developer.wordpress.com/docs/api/
  x-derived-from: https://public-api.wordpress.com/wpcom/v2/
  x-derived-by: API Evangelist enrichment pipeline
servers:
- url: https://public-api.wordpress.com
security:
- bearerAuth: []
tags:
- name: agency
paths:
  /wpcom/v2/agency:
    get:
      operationId: getWpcomV2Agency
      summary: GET /wpcom/v2/agency
      tags:
      - agency
      responses:
        '200':
          description: OK
        '401':
          description: Authentication required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
    post:
      operationId: postWpcomV2Agency
      summary: POST /wpcom/v2/agency
      tags:
      - agency
      responses:
        '200':
          description: OK
        '401':
          description: Authentication required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                first_name:
                  type: string
                last_name:
                  type: string
                agency_name:
                  type: string
                agency_url:
                  type: string
                initial_source:
                  type: string
                address_line1:
                  type: string
                  default: ''
                address_line2:
                  type: string
                  default: ''
                address_city:
                  type: string
                address_state:
                  type: string
                  default: ''
                address_postal_code:
                  type: string
                  default: ''
                address_country:
                  type: string
                agency_size:
                  type: string
                number_sites:
                  type: string
                services_offered:
                  type: array
                  items:
                    type: string
                products_offered:
                  type: array
                  items:
                    type: string
                products_to_offer:
                  type: array
                  items:
                    type: string
                expansion_planned:
                  type: string
                referral_url:
                  type: string
                referral_status:
                  type: string
                hubspotutk:
                  type: string
                bypass_duplicate_check:
                  type: boolean
                  default: false
                skip_hubspot:
                  type: boolean
                  default: false
              required:
              - first_name
              - last_name
              - agency_name
              - agency_url
              - address_city
              - address_country
  /wpcom/v2/agency/blog/{blog_id}:
    get:
      operationId: getWpcomV2AgencyBlogbyBlogId
      summary: GET /wpcom/v2/agency/blog/{blog_id}
      tags:
      - agency
      responses:
        '200':
          description: OK
        '401':
          description: Authentication required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
      parameters:
      - name: blog_id
        in: path
        required: true
        schema:
          type: string
  /wpcom/v2/agency/embeds/tipalti:
    get:
      operationId: getWpcomV2AgencyEmbedsTipalti
      summary: GET /wpcom/v2/agency/embeds/tipalti
      tags:
      - agency
      responses:
        '200':
          description: OK
        '401':
          description: Authentication required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
      parameters:
      - name: agency_id
        in: query
        required: true
        schema:
          type: integer
  /wpcom/v2/agency/exists/name:
    get:
      operationId: getWpcomV2AgencyExistsName
      summary: GET /wpcom/v2/agency/exists/name
      tags:
      - agency
      responses:
        '200':
          description: OK
        '401':
          description: Authentication required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
      parameters:
      - name: value
        in: query
        required: true
        schema:
          type: string
  /wpcom/v2/agency/exists/url:
    get:
      operationId: getWpcomV2AgencyExistsUrl
      summary: GET /wpcom/v2/agency/exists/url
      tags:
      - agency
      responses:
        '200':
          description: OK
        '401':
          description: Authentication required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
      parameters:
      - name: value
        in: query
        required: true
        schema:
          type: string
  /wpcom/v2/agency/help/pressable/support:
    post:
      operationId: postWpcomV2AgencyHelpPressableSupport
      summary: POST /wpcom/v2/agency/help/pressable/support
      tags:
      - agency
      responses:
        '200':
          description: OK
        '401':
          description: Authentication required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                email:
                  type: string
                site:
                  type: string
                contact_type:
                  type: string
                pressable_id:
                  type: string
                message:
                  type: string
              required:
              - name
              - email
              - contact_type
              - message
  /wpcom/v2/agency/help/zendesk/create-ticket:
    post:
      operationId: postWpcomV2AgencyHelpZendeskCreateTicket
      summary: POST /wpcom/v2/agency/help/zendesk/create-ticket
      tags:
      - agency
      responses:
        '200':
          description: OK
        '401':
          description: Authentication required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                email:
                  type: string
                product:
                  type: string
                message:
                  type: string
                tags:
                  type: array
                  items:
                    type: string
              required:
              - name
              - email
              - product
              - message
  /wpcom/v2/agency/hire-an-expert:
    post:
      operationId: postWpcomV2AgencyHireAnExpert
      summary: POST /wpcom/v2/agency/hire-an-expert
      tags:
      - agency
      responses:
        '200':
          description: OK
        '401':
          description: Authentication required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                full_name:
                  type: string
                email:
                  type: string
                company_name:
                  type: string
                url:
                  type: string
                business_description:
                  type: string
                project_goal:
                  type: string
                project_description:
                  type: string
                timeline:
                  type: string
                budget:
                  type: string
                business_unit:
                  type: string
              required:
              - full_name
              - email
  /wpcom/v2/agency/hubspot/webhook:
    post:
      operationId: postWpcomV2AgencyHubspotWebhook
      summary: POST /wpcom/v2/agency/hubspot/webhook
      tags:
      - agency
      responses:
        '200':
          description: OK
        '401':
          description: Authentication required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
  /wpcom/v2/agency/lead-matching/client:
    post:
      operationId: postWpcomV2AgencyLeadMatchingClient
      summary: POST /wpcom/v2/agency/lead-matching/client
      tags:
      - agency
      responses:
        '200':
          description: OK
        '401':
          description: Authentication required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
  /wpcom/v2/agency/license:
    delete:
      operationId: deleteWpcomV2AgencyLicense
      summary: DELETE /wpcom/v2/agency/license
      tags:
      - agency
      responses:
        '200':
          description: OK
        '401':
          description: Authentication required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
      parameters:
      - name: args
        in: query
        required: false
        schema: {}
  /wpcom/v2/agency/license/dev-site:
    get:
      operationId: getWpcomV2AgencyLicenseDevSite
      summary: GET /wpcom/v2/agency/license/dev-site
      tags:
      - agency
      responses:
        '200':
          description: OK
        '401':
          description: Authentication required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
      parameters:
      - name: args
        in: query
        required: false
        schema: {}
  /wpcom/v2/agency/partner-directory:
    get:
      operationId: getWpcomV2AgencyPartnerDirectory
      summary: GET /wpcom/v2/agency/partner-directory
      tags:
      - agency
      responses:
        '200':
          description: OK
        '401':
          description: Authentication required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
      parameters:
      - name: partner_directory
        in: query
        required: false
        schema:
          type: string
  /wpcom/v2/agency/partner-directory/form-submission:
    post:
      operationId: postWpcomV2AgencyPartnerDirectoryFormSubmission
      summary: POST /wpcom/v2/agency/partner-directory/form-submission
      tags:
      - agency
      responses:
        '200':
          description: OK
        '401':
          description: Authentication required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                agency_id:
                  type: string
                agency_email:
                  type: string
                full_name:
                  type: string
                email:
                  type: string
                business_name:
                  type: string
                project_description:
                  type: string
                project_type:
                  type: string
                url:
                  type: string
                budget:
                  type: string
              required:
              - agency_id
              - agency_email
              - full_name
              - email
              - business_name
              - project_type
              - budget
  /wpcom/v2/agency/partner-directory/{agency_id}:
    get:
      operationId: getWpcomV2AgencyPartnerDirectorybyAgencyId
      summary: GET /wpcom/v2/agency/partner-directory/{agency_id}
      tags:
      - agency
      responses:
        '200':
          description: OK
        '401':
          description: Authentication required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
      parameters:
      - name: agency_id
        in: path
        required: true
        schema:
          type: string
  /wpcom/v2/agency/pressable/new-account:
    post:
      operationId: postWpcomV2AgencyPressableNewAccount
      summary: POST /wpcom/v2/agency/pressable/new-account
      tags:
      - agency
      responses:
        '200':
          description: OK
        '401':
          description: Authentication required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                email:
                  type: string
                chargify_id:
                  type: integer
                pressable_id:
                  type: integer
              required:
              - email
              - chargify_id
  /wpcom/v2/agency/pressable/premium-plan-referral:
    post:
      operationId: postWpcomV2AgencyPressablePremiumPlanReferral
      summary: POST /wpcom/v2/agency/pressable/premium-plan-referral
      tags:
      - agency
      responses:
        '200':
          description: OK
        '401':
          description: Authentication required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                agency_id:
                  type: integer
                company_name:
                  type: string
                address:
                  type: string
                country_code:
                  type: string
                state:
                  type: string
                city:
                  type: string
                zip:
                  type: string
                first_name:
                  type: string
                last_name:
                  type: string
                title:
                  type: string
                phone:
                  type: string
                email:
                  type: string
                website:
                  type: string
                opportunity_description:
                  type: string
              required:
              - agency_id
              - company_name
              - address
              - country_code
              - city
              - zip
              - first_name
              - last_name
              - title
              - email
              - website
              - opportunity_description
  /wpcom/v2/agency/products:
    get:
      operationId: getWpcomV2AgencyProducts
      summary: GET /wpcom/v2/agency/products
      tags:
      - agency
      responses:
        '200':
          description: OK
        '401':
          description: Authentication required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
  /wpcom/v2/agency/resources:
    get:
      operationId: getWpcomV2AgencyResources
      summary: GET /wpcom/v2/agency/resources
      tags:
      - agency
      responses:
        '200':
          description: OK
        '401':
          description: Authentication required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
  /wpcom/v2/agency/resources/record-event:
    post:
      operationId: postWpcomV2AgencyResourcesRecordEvent
      summary: POST /wpcom/v2/agency/resources/record-event
      tags:
      - agency
      responses:
        '200':
          description: OK
        '401':
          description: Authentication required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                agency_id:
                  type: integer
                  description: The agency ID.
                resource_id:
                  type: string
                resource_name:
                  type: string
              required:
              - agency_id
              - resource_id
              - resource_name
  /wpcom/v2/agency/signup:
    post:
      operationId: postWpcomV2AgencySignup
      summary: POST /wpcom/v2/agency/signup
      tags:
      - agency
      responses:
        '200':
          description: OK
        '401':
          description: Authentication required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                first_name:
                  type: string
                last_name:
                  type: string
                email:
                  type: string
                agency_name:
                  type: string
                agency_url:
                  type: string
                initial_source:
                  type: string
                address_line1:
                  type: string
                  default: ''
                address_line2:
                  type: string
                  default: ''
                address_city:
                  type: string
                  default: ''
                address_state:
                  type: string
                  default: ''
                address_postal_code:
                  type: string
                  default: ''
                address_country:
                  type: string
                agency_size:
                  type: string
                number_sites:
                  type: string
                services_offered:
                  type: array
                  items:
                    type: string
                products_offered:
                  type: array
                  items:
                    type: string
                products_to_offer:
                  type: array
                  items:
                    type: string
                expansion_planned:
                  type: string
                referral_url:
                  type: string
                referral_status:
                  type: string
                top_partnering_goal:
                  type: string
                top_yearly_goal:
                  type: string
                work_with_clients:
                  type: string
                work_with_clients_other:
                  type: string
                  default: ''
                approach_and_challenges:
                  type: string
                  default: ''
              required:
              - first_name
              - last_name
              - email
              - agency_name
              - agency_url
              - address_country
  /wpcom/v2/agency/signup-context:
    get:
      operationId: getWpcomV2AgencySignupContext
      summary: GET /wpcom/v2/agency/signup-context
      tags:
      - agency
      responses:
        '200':
          description: OK
        '401':
          description: Authentication required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
  /wpcom/v2/agency/signup/contact-support:
    post:
      operationId: postWpcomV2AgencySignupContactSupport
      summary: POST /wpcom/v2/agency/signup/contact-support
      tags:
      - agency
      responses:
        '200':
          description: OK
        '401':
          description: Authentication required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                email:
                  type: string
                message:
                  type: string
                signup_agency_name:
                  type: string
                signup_agency_url:
                  type: string
                tags:
                  type: array
                  items:
                    type: string
              required:
              - name
              - email
              - message
  /wpcom/v2/agency/user-feedback:
    post:
      operationId: postWpcomV2AgencyUserFeedback
      summary: POST /wpcom/v2/agency/user-feedback
      tags:
      - agency
      responses:
        '200':
          description: OK
        '401':
          description: Authentication required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                source_url:
                  type: string
                rating:
                  type: integer
                feedback:
                  type: string
              required:
              - source_url
              - rating
              - feedback
  /wpcom/v2/agency/validate/{field}:
    get:
      operationId: getWpcomV2AgencyValidatebyField
      summary: GET /wpcom/v2/agency/validate/{field}
      tags:
      - agency
      responses:
        '200':
          description: OK
        '401':
          description: Authentication required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
      parameters:
      - name: field
        in: path
        required: true
        schema:
          type: string
      - name: value
        in: query
        required: true
        schema:
          type: string
  /wpcom/v2/agency/vip/partner-opportunity:
    post:
      operationId: postWpcomV2AgencyVipPartnerOpportunity
      summary: POST /wpcom/v2/agency/vip/partner-opportunity
      tags:
      - agency
      responses:
        '200':
          description: OK
        '401':
          description: Authentication required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                agency_id:
                  type: integer
                company_name:
                  type: string
                address:
                  type: string
                country_code:
                  type: string
                state:
                  type: string
                city:
                  type: string
                zip:
                  type: string
                first_name:
                  type: string
                last_name:
                  type: string
                title:
                  type: string
                phone:
                  type: string
                email:
                  type: string
                website:
                  type: string
                opportunity_description:
                  type: string
                lead_type:
                  type: string
                is_rfp:
                  type: boolean
              required:
              - agency_id
              - company_name
              - address
              - country_code
              - city
              - zip
              - first_name
              - last_name
              - title
              - email
              - website
              - opportunity_description
              - lead_type
              - is_rfp
  /wpcom/v2/agency/{agency_id}:
    put:
      operationId: putWpcomV2AgencybyAgencyId
      summary: PUT /wpcom/v2/agency/{agency_id}
      tags:
      - agency
      responses:
        '200':
          description: OK
        '401':
          description: Authentication required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
      parameters:
      - name: agency_id
        in: path
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                agency_name:
                  type: string
                agency_url:
                  type: string
                address_line1:
                  type: string
                address_line2:
                  type: string
                address_city:
                  type: string
                address_state:
                  type: string
                address_postal_code:
                  type: string
                address_country:
                  type: string
  /wpcom/v2/agency/{agency_id}/a4a-mcp/settings:
    get:
      operationId: getWpcomV2AgencybyAgencyIdA4AMcpSettings
      summary: GET /wpcom/v2/agency/{agency_id}/a4a-mcp/settings
      tags:
      - agency
      responses:
        '200':
          description: OK
        '401':
          description: Authentication required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
      parameters:
      - name: agency_id
        in: path
        required: true
        schema:
          type: string
    post:
      operationId: postWpcomV2AgencybyAgencyIdA4AMcpSettings
      summary: POST /wpcom/v2/agency/{agency_id}/a4a-mcp/settings
      tags:
      - agency
      responses:
        '200':
          description: OK
        '401':
          description: Authentication required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WPRestError'
      parameters:
      - name: agency_id
   

# --- truncated at 32 KB (122 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/automattic/refs/heads/main/openapi/automattic-agency-api-openapi.yml