Activepieces is an open-source automation platform, available in the cloud or self-hosted. You can connect Perfect Wiki to Activepieces today in two ways:
- HTTP piece + Perfect Wiki Public API. Best for regular flows that create, update or read pages on a trigger, for example "when a new employee is added in the HR system, create their onboarding page."
- MCP Client piece + Perfect Wiki MCP server. Call Perfect Wiki tools such as
askorcreate_pageby signing in with your Perfect Wiki account, with no API token to manage.
| HTTP piece + Public API | MCP Client piece + MCP server | |
|---|---|---|
| Authentication | API token (one per knowledgebase) | Sign in with your Perfect Wiki account (OAuth) |
| Knowledgebases | One per token | One or several, chosen on the consent screen |
| Requires | Any Activepieces version | Activepieces 0.93.0 or later |
| Good for | Full control over each request | Calling Perfect Wiki tools without building requests |
Option 1: HTTP piece and the Public API
Step 1. Get an API token
- Open the Perfect Wiki administration panel.
- Find the knowledgebase you want Activepieces to work with.
- Open the API Access section and click Generate API Key.
- Copy the token right away. It is shown only once.
Each token works with one knowledgebase. Full details are in 🔌 Perfect Wiki Public API.
Step 2. Add an HTTP "Send HTTP request" step
- In your flow, add the HTTP piece and choose Send HTTP request.
- Set the method and URL from the table below.
- Set the authentication to Bearer Token and paste your Perfect Wiki token.
- For POST requests, choose a JSON body and paste the JSON. Use the data selector to insert values from earlier steps.
| What you want to do | Method | URL |
|---|---|---|
| List pages | GET | https://api.perfectwiki.xyz/api/public-api/v1/knowledgebase |
| Read a page | GET | https://api.perfectwiki.xyz/api/public-api/v1/page/PAGE_ID |
| Create a page | POST | https://api.perfectwiki.xyz/api/public-api/v1/page |
| Update a page | POST | https://api.perfectwiki.xyz/api/public-api/v1/page/PAGE_ID |
| Delete a page | DELETE | https://api.perfectwiki.xyz/api/public-api/v1/page/PAGE_ID |
| Ask a question (AI answer) | POST | https://api.perfectwiki.xyz/api/public-api/v1/knowledgebase/query |
Page content must be HTML, not Markdown.
Example: create an onboarding page for a new hire
{
"title": "Welcome, <first name> <last name>",
"content": "<p>Start date: <start date></p><p>Manager: <manager></p>",
"tags": ["onboarding"],
"parentId": "ONBOARDING_PARENT_PAGE_ID"
}Replace the values in angle brackets with fields from your trigger using the data selector. The response contains the new page ID in page.id, which later steps can use to update the page or share its link.
Example: answer a question from your knowledgebase
POST https://api.perfectwiki.xyz/api/public-api/v1/knowledgebase/query
{ "q": "<question>" }The answer is in aiBotResponse.response, and links to the source pages are in aiBotResponse.relatedPages. Each call counts as an AI request on your plan.
Option 2: MCP Client piece and the MCP server
You need Activepieces 0.93.0 or later, which added OAuth 2.0 sign-in to the MCP Client piece. If you self-host Activepieces, upgrade first.
- In your flow, add the MCP Client piece and choose Call Tool.
- Create a new connection with the OAuth 2.0 option and enter the server URL
https://api.perfectwiki.xyz/mcp. - Click to authorize. A Perfect Wiki sign-in window opens: choose the knowledgebases and the access level (Read only or Read & Write), and approve.
- Pick the tool to call and fill in its inputs. For example, choose
askand map a question from an earlier step.
Available tools: ask, list_knowledgebases, get_knowledgebase, list_pages, get_page, create_page, update_page and delete_page. Read more in 🔌 Perfect Wiki MCP Server.
Tip: to test the connection, call
list_knowledgebases. It should return the knowledgebases you selected when signing in.
FAQ
Is there a dedicated Perfect Wiki piece in Activepieces?
Not yet. The HTTP and MCP Client pieces give you full access to Perfect Wiki today. If you'd like a dedicated piece, let us know at docs.perfectwiki.com/feedback.
I don't see the OAuth option in the MCP Client piece.
Your Activepieces version is older than 0.93.0. Upgrade, or use Option 1 with the HTTP piece instead.
Can a flow start when a page is created or changed?
Perfect Wiki doesn't send webhooks yet. To react to changes, use a Schedule trigger that lists pages on a regular interval and compares the results.
Are there rate limits?
Yes: 10 requests per second and 60 per minute for each token. In a loop, add a Delay step between requests. A 429 error means you hit the limit; wait and retry.
I'm getting a 402 error.
If the code is TRIAL_EXPIRED, your free trial has ended and API access is paused until your organization picks a paid plan. If you only get 402 from the AI query endpoint, you've used this month's AI query allowance; the other endpoints keep working.
Which other automation tools work with Perfect Wiki?
Zapier, Power Automate, n8n, Make and Pipedream.
Need help?
If something doesn't work as expected, contact support.