Piwik PRO OAuth API

The OAuth API from Piwik PRO — 1 operation(s) for oauth.

GitHub OpenAPI

Operations 1

POST /auth/token Issue OAuth Token #

Specifications

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/piwik-pro:piwik-pro-oauth-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

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

OpenAPI Specification

piwik-pro-oauth-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Web OAuth API
  version: master
servers:
- url: https://{account}.piwik.pro
  variables:
    account:
      default: example
security:
- OAuth2ClientCredentials: []
tags:
- name: OAuth
paths:
  /auth/token:
    post:
      summary: Issue OAuth Token
      description: 'Creates access token for OAuth client credentials grant.


        This endpoint is rate limited to 60 requests per minute per client and source IP address.

        When the limit is exceeded, the endpoint responds with HTTP 429.

        Reuse the issued token until it expires instead of requesting a new one for each API call.'
      operationId: oauth_token_issue
      security: []
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                grant_type:
                  description: Type of grant which for token will be issued
                  type: string
                  example: client_credentials
                client_id:
                  description: Client Identifier
                  type: string
                client_secret:
                  description: Client Secret
                  type: string
              required:
              - grant_type
              - client_id
              - client_secret
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                grant_type:
                  description: Type of grant which for token will be issued
                  type: string
                  example: client_credentials
                client_id:
                  description: Client Identifier
                  type: string
                client_secret:
                  description: Client Secret
                  type: string
              required:
              - grant_type
              - client_id
              - client_secret
      responses:
        '200':
          description: OK
          content:
            application/json; charset=UTF-8:
              schema:
                type: object
                properties:
                  access_token:
                    type: string
                    description: Access token (JWT format)
                    example: eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJpc3MiOiJvYXV0aCIsImF1ZCI6IkNsaWVudC1OYW1lLVdqZFRjSjQyIiwiaWF0IjoxNjgwMjYwNzQyLCJleHAiOjE2ODAyNjI1NDIsInN1YiI6ImRiZTg3ZDlmLWMxYWItNGM4ZC05YWJjLTQ1MWViMzA3MTM2NyIsIm9yZyI6ImRlZmF1bHQiLCJlbWwiOiJleGFtcGxlQHBpd2lrLnBybyJ9.XDfDhKN0RInyHQBhzJD8ul_ai047QaAnQQfFQRzsJqoom0rOCir7aO4GGaJsBdWDamaFUiRC15jTH7l-TANqkHd1TV4ujDQJoKRdUt7vCxd1NdH8S6hXfDUJhVjNYYs-CLb08Od2-CqfTuR8SA3CCZX-jQRCGZjeMe6AlSwV-wEt3zgKTs8tzxThKd3KH6uKTmJRmKK-zObEPx4mYCPjpz-32LNqD-XKV1Th21aElz0X18pmahREWCcA8qHYnxOrTVFO9pPuTOvsHx9Wo8m1zou5s9u9PzFapScO_Wi7n6QpMObaLrxtd3T1Bk0eIwi2ujYIeb7wPWYJdcB3qmfBkg
                  expires_in:
                    type: integer
                    enum:
                    - 1800
                    description: TTL of access token
                  token_type:
                    type: string
                    enum:
                    - Bearer
                    description: Bearer token type
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                type: object
                required:
                - error
                properties:
                  error:
                    type: string
                    description: Error code
                  error_description:
                    type: string
                    description: Error description
                  hint:
                    type: string
                    description: Hint for error
                  message:
                    type: string
                    description: Error message
              examples:
                InvalidClientDetailed:
                  value:
                    error: invalid_client
                    error_description: The request is missing a required parameter, includes an invalid parameter value, includes a parameter more than once, or is otherwise malformed.
                    hint: Check the `client_id` parameter
                    message: The request is missing a required parameter, includes an invalid parameter value, includes a parameter more than once, or is otherwise malformed.
                InvalidClient:
                  value:
                    error: invalid_client
                    error_description: The client is invalid or does not exist on this server.
                UnsupportedGrantType:
                  value:
                    error: unsupported_grant_type
                    error_description: The authorization grant type is not supported by the authorization server.
                    hint: Check that all required parameters have been provided
                    message: The authorization grant type is not supported by the authorization server.
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Client authentication failed
                    enum:
                    - invalid_client
        '402':
          description: Payment Required
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    description: Payment Required
                    enum:
                    - 402
                  message:
                    type: string
                    description: Error description for inactive license for organization
                    example: There is no active license for "default" organization
        '429':
          description: Too Many Requests - Rate limit exceeded
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                    enum:
                    - Rate limit exceeded.
      tags:
      - OAuth
components:
  securitySchemes:
    OAuth2ClientCredentials:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: /auth/token
          scopes: {}
    JWTAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
x-api-checksum: f30b118d8e5a9d203105c80d9cf4000e1fd797fefe12353beea7e379e41e6e6c
x-provenance:
  method: searched
  source: https://developers.piwik.pro/reference
  harvested: '2026-11-16'
  tool: harvest-readme-openapi.py
  note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
  assembled_from:
  - https://developers.piwik.pro/reference/_legacy_get_permission_groups_v2.md
  - https://developers.piwik.pro/reference/_legacy_set_permission_group_v2.md
  - https://developers.piwik.pro/reference/accessible_modules_for_users_batch.md
  - https://developers.piwik.pro/reference/add_apps_to_meta_site_v1.md
  - https://developers.piwik.pro/reference/add_meta_site_v1.md
  - https://developers.piwik.pro/reference/add_user_group_v1.md
  - https://developers.piwik.pro/reference/add_users_to_group_v1.md
  - https://developers.piwik.pro/reference/api_app_add_v2.md
  - https://developers.piwik.pro/reference/api_app_delete_v2.md
  - https://developers.piwik.pro/reference/api_app_edit_v2.md
  - https://developers.piwik.pro/reference/api_app_list_v2.md
  - https://developers.piwik.pro/reference/api_apps_details_v2.md
  - https://developers.piwik.pro/reference/api_apps_permissions_v2.md
  - https://developers.piwik.pro/reference/api_apps_user_group_permissions_v2.md
  - https://developers.piwik.pro/reference/api_delete_app_tracker_setting_v2.md
  - https://developers.piwik.pro/reference/api_edit_app_tracker_settings_v2.md
  - https://developers.piwik.pro/reference/api_edit_global_tracker_settings_v2.md
  - https://developers.piwik.pro/reference/api_get_app_by_url_tracker_settings_v2.md
  - https://developers.piwik.pro/reference/api_get_app_tracker_settings_v2.md
  - https://developers.piwik.pro/reference/api_get_global_tracker_settings_v2.md
  - https://developers.piwik.pro/reference/api_users_add_v2.md
  - https://developers.piwik.pro/reference/api_users_change_role_v2.md
  - https://developers.piwik.pro/reference/api_users_delete_v2.md
  - https://developers.piwik.pro/reference/api_users_edit_v2.md
  - https://developers.piwik.pro/reference/api_users_invited_v2.md
  - https://developers.piwik.pro/reference/api_users_list_v2.md
  - https://developers.piwik.pro/reference/api_users_me_change_password_v2.md
  - https://developers.piwik.pro/reference/api_users_me_details_v2.md
  - https://developers.piwik.pro/reference/api_users_me_edit_v2.md
  - https://developers.piwik.pro/reference/api_users_user_details_v2.md
  - https://developers.piwik.pro/reference/audit_log_entries_v1.md
  - https://developers.piwik.pro/reference/delete-audience.md
  - https://developers.piwik.pro/reference/delete-profile-by-identifier.md
  - https://developers.piwik.pro/reference/delete-settings-activation.md
  - https://developers.piwik.pro/reference/delete_api-analytics-v1-manage-annotation-user-id.md
  - https://developers.piwik.pro/reference/delete_api-analytics-v1-manage-goals-id.md
  - https://developers.piwik.pro/reference/delete_api-container-settings-v1-app-app-id-settings-setting-name.md
  - https://developers.piwik.pro/reference/delete_api-tag-v1-app-id-tags-tag-id.md
  - https://developers.piwik.pro/reference/delete_api-tag-v1-app-id-triggers-trigger-id.md
  - https://developers.piwik.pro/reference/delete_api-tag-v1-app-id-variables-variable-id.md
  - https://developers.piwik.pro/reference/delete_api-tag-v1-app-id-versions-version-id-debug-links-debug-link-id.md
  - https://developers.piwik.pro/reference/delete_meta_site_v1.md
  - https://developers.piwik.pro/reference/delete_user_group_v1.md
  - https://developers.piwik.pro/reference/deprecated_api_user_details_v2.md
  - https://developers.piwik.pro/reference/edit_meta_site_v1.md
  - https://developers.piwik.pro/reference/edit_user_group_v1.md
  - https://developers.piwik.pro/reference/get-audience.md
  - https://developers.piwik.pro/reference/get-audiences.md
  - https://developers.piwik.pro/reference/get-enum.md
  - https://developers.piwik.pro/reference/get-fetch-activation-usage-stats.md
  - https://developers.piwik.pro/reference/get-import-webhook-request.md
  - https://developers.piwik.pro/reference/get-integration-gads-app-conversion-actions.md
  - https://developers.piwik.pro/reference/get-integration-gads-app-customer-id.md
  - https://developers.piwik.pro/reference/get-integration-gads-app-user-lists.md
  - https://developers.piwik.pro/reference/get-log-activation-details.md
  - https://developers.piwik.pro/reference/get-log-activation-last-v3.md
  - https://developers.piwik.pro/reference/get-log-activation-last.md
  - https://developers.piwik.pro/reference/get-log-activation-stats.md
  - https://developers.piwik.pro/reference/get-log-audience-version-profile-count.md
  - https://developers.piwik.pro/reference/get-log-audience-version-profile-last-v3.md
  - https://developers.piwik.pro/reference/get-log-audience-version-profile-last.md
  - https://developers.piwik.pro/reference/get-log-import-webhook-requests-last-v3.md
  - https://developers.piwik.pro/reference/get-log-import-webhook-requests-last.md
  - https://developers.piwik.pro/reference/get-log-import-webhook-requests-stats.md
  - https://developers.piwik.pro/reference/get-profile-audiences.md
  - https://developers.piwik.pro/reference/get-profile-by-identifier.md
  - https://developers.piwik.pro/reference/get-profile-public-attributes.md
  - https://developers.piwik.pro/reference/get-profiles-activation-usage-stats.md
  - https://developers.piwik.pro/reference/get-settings-activation.md
  - https://developers.piwik.pro/reference/get-settings-activations.md
  - https://developers.piwik.pro/reference/get-settings-app-attributes.md
  - https://developers.piwik.pro/reference/get-webhook-import.md
  - https://developers.piwik.pro/reference/get_api-analytics-v1-manage-annotation-system.md
  - https://developers.piwik.pro/reference/get_api-analytics-v1-manage-annotation-user-id.md
  - https://developers.piwik.pro/reference/get_api-analytics-v1-manage-annotation-user.md
  - https://developers.piwik.pro/reference/get_api-analytics-v1-manage-custom-dimensions-id.md
  - https://developers.piwik.pro/reference/get_api-analytics-v1-manage-custom-dimensions-slots.md
  - https://developers.piwik.pro/reference/get_api-analytics-v1-manage-custom-dimensions.md
  - https://developers.piwik.pro/reference/get_api-analytics-v1-manage-goals-id.md
  - https://developers.piwik.pro/reference/get_api-analytics-v1-manage-goals.md
  - https://developers.piwik.pro/reference/get_api-analytics-v1-manage-product-custom-dimensions-id.md
  - https://developers.piwik.pro/reference/get_api-analytics-v1-manage-product-custom-dimensions.md
  - https://developers.piwik.pro/reference/get_api-container-settings-v1-app-app-id-default-settings.md
  - https://developers.piwik.pro/reference/get_api-container-settings-v1-app-app-id-installation-code.md
  - https://developers.piwik.pro/reference/get_api-container-settings-v1-app-app-id-settings-setting-name.md
  - https://developers.piwik.pro/reference/get_api-container-settings-v1-app-app-id-settings.md
  - https://developers.piwik.pro/reference/get_api-container-settings-v1-organization-organization-opt-out-code.md
  - https://developers.piwik.pro/reference/get_api-container-settings-v1-organization-organization-settings-setting-name.md
  - https://developers.piwik.pro/reference/get_api-container-settings-v1-organization-organization-settings.md
  - https://developers.piwik.pro/reference/get_api-tag-v1-app-id-operations-operation-id.md
  - https://developers.piwik.pro/reference/get_api-tag-v1-app-id-tags-tag-id-triggers.md
  - https://developers.piwik.pro/reference/get_api-tag-v1-app-id-tags-tag-id-variables.md
  - https://developers.piwik.pro/reference/get_api-tag-v1-app-id-tags-tag-id.md
  - https://developers.piwik.pro/reference/get_api-tag-v1-app-id-tags.md
  - https://developers.piwik.pro/reference/get_api-tag-v1-app-id-triggers-trigger-id-tags.md
  - https://developers.piwik.pro/reference/get_api-tag-v1-app-id-triggers-trigger-id-triggers.md
  - https://developers.piwik.pro/reference/get_api-tag-v1-app-id-triggers-trigger-id-variables.md
  - https://developers.piwik.pro/reference/get_api-tag-v1-app-id-triggers-trigger-id.md
  - https://developers.piwik.pro/reference/get_api-tag-v1-app-id-triggers.md
  - https://developers.piwik.pro/reference/get_api-tag-v1-app-id-variables-variable-id-required-by-variables.md
  - https://developers.piwik.pro/reference/get_api-tag-v1-app-id-variables-variable-id-required-variables.md
  - https://developers.piwik.pro/reference/get_api-tag-v1-app-id-variables-variable-id-tags.md
  - https://developers.piwik.pro/reference/get_api-tag-v1-app-id-variables-variable-id-triggers.md
  - https://developers.piwik.pro/reference/get_api-tag-v1-app-id-variables-variable-id.md
  - https://developers.piwik.pro/reference/get_api-tag-v1-app-id-variables.md
  - https://developers.piwik.pro/reference/get_api-tag-v1-app-id-versions-draft.md
  - https://developers.piwik.pro/reference/get_api-tag-v1-app-id-versions-published.md
  - https://developers.piwik.pro/reference/get_api-tag-v1-app-id-versions-version-id-changelog.md
  - https://developers.piwik.pro/reference/get_api-tag-v1-app-id-versions-version-id-debug-links.md
  - https://developers.piwik.pro/reference/get_api-tag-v1-app-id-versions-version-id-export-files-export-file-id.md
  - https://developers.piwik.pro/reference/get_api-tag-v1-app-id-versions-version-id-overview.md
  - https://developers.piwik.pro/reference/get_api-tag-v1-app-id-versions-version-id.md
  - https://developers.piwik.pro/reference/get_api-tag-v1-app-id-versions.md
  - https://developers.piwik.pro/reference/get_api-tracker-v1-debugger.md
  - https://developers.piwik.pro/reference/get_api-tracker-v1-log.md
  - https://developers.piwik.pro/reference/get_api-tracker-v1-settings-app-global.md
  - https://developers.piwik.pro/reference/get_apps_with_action_v2.md
  - https://developers.piwik.pro/reference/get_entity_actions_v2.md
  - https://developers.piwik.pro/reference/get_global_actions_v2.md
  - https://developers.piwik.pro/reference/get_meta_site_v11.md
  - https://developers.piwik.pro/reference/get_meta_sites_with_action_v2.md
  - https://developers.piwik.pro/reference/get_module_v1.md
  - https://developers.piwik.pro/reference/get_ppms-php.md
  - https://developers.piwik.pro/reference/get_user_modules_access_v1.md
  - https://developers.piwik.pro/reference/get_users_with_action_v2.md
  - https://developers.piwik.pro/reference/list-webhook-imports.md
  - https://developers.piwik.pro/reference/list_app_permissions_for_user_group_v2.md
  - https://developers.piwik.pro/reference/list_app_permissions_for_user_v2.md
  - https://developers.piwik.pro/reference/list_apps_and_meta_sites_v1.md
  - https://developers.piwik.pro/reference/list_apps_excluded_from_meta_site_v1.md
  - https://developers.piwik.pro/reference/list_apps_in_meta_site_v1.md
  - https://developers.piwik.pro/reference/list_meta_site_permissions_for_user_group_v2.md
  - https://developers.piwik.pro/reference/list_meta_site_permissions_for_user_v2.md
  - https://developers.piwik.pro/reference/list_meta_site_v1.md
  - https://developers.piwik.pro/reference/list_modules_v1.md
  - https://developers.piwik.pro/reference/list_user_group_users_excluded_v1.md
  - https://developers.piwik.pro/reference/list_user_group_users_v1.md
  - https://developers.piwik.pro/reference/list_user_group_v1.md
  - https://developers.piwik.pro/reference/meta_site_integrity_v1.md
  - https://developers.piwik.pro/reference/oauth_token_issue.md
  - https://developers.piwik.pro/reference/patch_api-analytics-v1-manage-annotation-user-id.md
  - https://developers.piwik.pro/reference/patch_api-container-settings-v1-app-app-id-settings.md
  - https://developers.piwik.pro/reference/patch_api-container-settings-v1-organization-organization-settings.md
  - https://developers.piwik.pro/reference/patch_api-tag-v1-app-id-tags-tag-id.md
  - https://developers.piwik.pro/reference/patch_api-tag-v1-app-id-tags.md
  - https://developers.piwik.pro/reference/patch_api-tag-v1-app-id-triggers-trigger-id.md
  - https://developers.piwik.pro/reference/patch_api-tag-v1-app-id-variables-variable-id.md
  - https://developers.piwik.pro/reference/patch_api-tag-v1-app-id-versions-version-id.md
  - https://developers.piwik.pro/reference/patch_api-tracker-v1-settings-app-global.md
  - https://developers.piwik.pro/reference/post-audience.md
  - https://developers.piwik.pro/reference/post-import-webhook-request.md
  - https://developers.piwik.pro/reference/post-profile-attributes.md
  - https://developers.piwik.pro/reference/post-settings-activation-activate.md
  - https://developers.piwik.pro/reference/post-settings-activation.md
  - https://developers.piwik.pro/reference/post-settings-app-custom-attribute-bulk.md
  - https://developers.piwik.pro/reference/post-settings-app-custom-attribute.md
  - https://developers.piwik.pro/reference/post-webhook-import-activate.md
  - https://developers.piwik.pro/reference/post-webhook-import.md
  - https://developers.piwik.pro/reference/post_api-analytics-v1-events.md
  - https://developers.piwik.pro/reference/post_api-analytics-v1-manage-annotation-user.md
  - https://developers.piwik.pro/reference/post_api-analytics-v1-manage-custom-dimensions.md
  - https://developers.piwik.pro/reference/post_api-analytics-v1-manage-goals.md
  - https://developers.piwik.pro/reference/post_api-analytics-v1-manage-product-custom-dimensions.md
  - https://developers.piwik.pro/reference/post_api-analytics-v1-query.md
  - https://developers.piwik.pro/reference/post_api-analytics-v1-real-time-events.md
  - https://developers.piwik.pro/reference/post_api-analytics-v1-real-time-query.md
  - https://developers.piwik.pro/reference/post_api-analytics-v1-sessions.md
  - https://developers.piwik.pro/reference/post_api-tag-v1-app-id-tags-tag-id-copy.md
  - https://developers.piwik.pro/reference/post_api-tag-v1-app-id-tags.md
  - https://developers.piwik.pro/reference/post_api-tag-v1-app-id-triggers-trigger-id-copy.md
  - https://developers.piwik.pro/reference/post_api-tag-v1-app-id-triggers.md
  - https://developers.piwik.pro/reference/post_api-tag-v1-app-id-variables-variable-id-copy.md
  - https://developers.piwik.pro/reference/post_api-tag-v1-app-id-variables.md
  - https://developers.piwik.pro/reference/post_api-tag-v1-app-id-versions-draft-publish.md
  - https://developers.piwik.pro/reference/post_api-tag-v1-app-id-versions-draft-snapshot.md
  - https://developers.piwik.pro/reference/post_api-tag-v1-app-id-versions-import-file.md
  - https://developers.piwik.pro/reference/post_api-tag-v1-app-id-versions-import.md
  - https://developers.piwik.pro/reference/post_api-tag-v1-app-id-versions-published-restore.md
  - https://developers.piwik.pro/reference/post_api-tag-v1-app-id-versions-version-id-debug-links.md
  - https://developers.piwik.pro/reference/post_api-tag-v1-app-id-versions-version-id-export-files.md
  - https://developers.piwik.pro/reference/post_api-tag-v1-app-id-versions-version-id-publish.md
  - https://developers.piwik.pro/reference/post_api-tag-v1-app-id-versions-version-id-restore.md
  - https://developers.piwik.pro/reference/post_ppms-php.md
  - https://developers.piwik.pro/reference/put-audience.md
  - https://developers.piwik.pro/reference/put-import-webhook-request.md
  - https://developers.piwik.pro/reference/put-settings-activation.md
  - https://developers.piwik.pro/reference/put-settings-app-custom-attribute.md
  - https://developers.piwik.pro/reference/put-webhook-import.md
  - https://developers.piwik.pro/reference/put_api-analytics-v1-manage-custom-dimensions-id.md
  - https://developers.piwik.pro/reference/put_api-analytics-v1-manage-goals-id.md
  - https://developers.piwik.pro/reference/put_api-analytics-v1-manage-product-custom-dimensions-id.md
  - https://developers.piwik.pro/reference/put_api-container-settings-v1-app-app-id-settings-setting-name.md
  - https://developers.piwik.pro/reference/put_api-container-settings-v1-organization-organization-settings-setting-name.md
  - https://developers.piwik.pro/reference/remove_apps_from_meta_site_v1.md
  - https://developers.piwik.pro/reference/remove_users_from_group_v1.md
  - https://developers.piwik.pro/reference/set_app_permission_for_user_group_v2.md
  - https://developers.piwik.pro/reference/set_app_permission_for_user_v2.md
  - https://developers.piwik.pro/reference/set_meta_site_permission_for_user_group_v2.md
  - https://developers.piwik.pro/reference/set_meta_site_permission_for_user_v2.md
  - https://developers.piwik.pro/reference/set_modules_access_v1.md
  - https://developers.piwik.pro/reference/set_permission_group_for_user_group_v1.md
  - https://developers.piwik.pro/reference/test-webhook.md
  - https://developers.piwik.pro/reference/update-attribute-accessibility.md
  - https://developers.piwik.pro/reference/usergroupdetails_v1.md
  merge:
    pages: 204
    deduped: 268
    conflicts_kept_first: 0