Piwik PRO OAuth API
The OAuth API from Piwik PRO — 1 operation(s) for oauth.
The OAuth API from Piwik PRO — 1 operation(s) for oauth.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/piwik-pro:piwik-pro-oauth-api"
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.
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: 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