CONNECT APP
Build with Peerdom
Organizational Change Made Easy.
Business Management
- API key
MCP
Give your agent Peerdom tools
Every Peerdom action is exposed as an MCP tool on Pipedream's remote server. Point a client at it with your end user's ID and Connect resolves that user's Peerdom account for each tool call — you store no tokens.
// accessToken: mint a short-lived token with the Connect SDK — see the MCP guide
const transport = new StreamableHTTPClientTransport(
new URL("https://remote.mcp.pipedream.net/v3"),
{
requestInit: {
headers: {
Authorization: `Bearer ${accessToken}`,
"x-pd-project-id": "{project_id}",
"x-pd-environment": "production",
"x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
"x-pd-app-slug": "peerdom",
},
},
},
)
const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)
const { tools } = await mcp.listTools()
// e.g. run Assign Member to Role:
const result = await mcp.callTool({
name: "peerdom-assign-member-to-role",
arguments: {
roleId: "Role ID",
memberId: "Member ID",
},
})# access_token: mint a short-lived token with the Connect SDK — see the MCP guide
headers = {
"Authorization": f"Bearer {access_token}",
"x-pd-project-id": "{project_id}",
"x-pd-environment": "production",
"x-pd-external-user-id": "{external_user_id}", # any stable ID for this user in your system
"x-pd-app-slug": "peerdom",
}
async with streamablehttp_client("https://remote.mcp.pipedream.net/v3", headers=headers) as (read, write, _):
async with ClientSession(read, write) as session:
await session.initialize()
tools = await session.list_tools()
# e.g. run Assign Member to Role:
result = await session.call_tool("peerdom-assign-member-to-role", {
"roleId": "Role ID",
"memberId": "Member ID",
})SDK
Run Peerdom actions from your backend
Connect a user's Peerdom account once, then run Assign Member to Role on their behalf from your own code — TypeScript, Python, or plain HTTP.
import { PipedreamClient } from "@pipedream/sdk"
const pd = new PipedreamClient({
projectId: process.env.PIPEDREAM_PROJECT_ID!,
clientId: process.env.PIPEDREAM_CLIENT_ID!,
clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
projectEnvironment: "production",
})
const result = await pd.actions.run({
id: "peerdom-assign-member-to-role",
externalUserId: "{external_user_id}", // any stable ID for this user in your system
configuredProps: {
peerdom: { authProvisionId: "apn_xxxxxxx" },
roleId: "Role ID",
memberId: "Member ID",
},
})from pipedream import Pipedream
pd = Pipedream(
client_id="{oauth_client_id}",
client_secret="{oauth_client_secret}",
project_id="{project_id}",
project_environment="production",
)
result = pd.actions.run(
id="peerdom-assign-member-to-role",
external_user_id="{external_user_id}", # any stable ID for this user in your system
configured_props={
"peerdom": {"authProvisionId": "apn_xxxxxxx"},
"roleId": "Role ID",
"memberId": "Member ID",
},
)curl -X POST https://api.pipedream.com/v1/connect/{project_id}/actions/run \
-H "Content-Type: application/json" \
-H "X-PD-Environment: production" \
-H "Authorization: Bearer {access_token}" \
-d '{
"external_user_id": "{external_user_id}",
"id": "peerdom-assign-member-to-role",
"configured_props": {
"peerdom": { "authProvisionId": "apn_xxxxxxx" },
"roleId": "Role ID",
"memberId": "Member ID"
}
}'TOOLS
Peerdom actions
On-demand operations your product or agent can configure and run on behalf of a connected user.
-
Assign Member to Role
actionAssigns a member to a role within a circle using the Peerdom API. See the documentationWritev0.0.2 -
Create Role
actionCreate a new role within a specified circle. See the documentationWritev0.0.2 -
List Group ID Options
actionRetrieves available options for the Group ID field.Read-onlyv0.0.1 -
List Map ID Options
actionRetrieves available options for the Map ID field.Read-onlyv0.0.1 -
List Member ID Options
actionRetrieves available options for the Member ID field.Read-onlyv0.0.1 -
List Role ID Options
actionRetrieves available options for the Role ID field.Read-onlyv0.0.1 -
Update Role
actionUpdate an existing role's attributes such as name, description, or linked domains. See the documentationWritev0.0.2
EVENTS
Peerdom triggers
Event sources your backend can deploy for users and receive through a webhook.
- App slug
- peerdom
- Authentication
- API key
- Categories
- Business Management
- Actions
- 7
- Triggers
- 2
- API proxy
- Not available