CONNECT APP
Build with Intuiface
Business Management
- API key
MCP
Give your agent Intuiface tools
Every Intuiface 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 Intuiface 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": "intuiface",
},
},
},
)
const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)
const { tools } = await mcp.listTools()
// e.g. run List Available Experiences:
const result = await mcp.callTool({
name: "intuiface-available-experiences",
arguments: {
experienceNames: ["Experience Names"],
experienceIds: ["Experience IDs"],
},
})# 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": "intuiface",
}
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 List Available Experiences:
result = await session.call_tool("intuiface-available-experiences", {
"experienceNames": ["Experience Names"],
"experienceIds": ["Experience IDs"],
})API PROXY
Call the Intuiface API directly
For an endpoint with no pre-built tool, the Connect proxy forwards your request to the Intuiface API with the connected user's credentials attached. You store no tokens and write no refresh logic.
const resp = await pd.proxy.get({
externalUserId: "{external_user_id}", // any stable ID for this user in your system
accountId: "apn_xxxxxxx",
url: "https://api.intuiface.com/webtriggers/v1/availableExperiences",
})
// Any allowed Intuiface endpoint works here. Pipedream attaches the
// connected account's credentials to the outgoing request.# The path segment is the target URL, URL-safe base64 encoded:
# https://api.intuiface.com/webtriggers/v1/availableExperiences
curl "https://api.pipedream.com/v1/connect/{project_id}/proxy/aHR0cHM6Ly9hcGkuaW50dWlmYWNlLmNvbS93ZWJ0cmlnZ2Vycy92MS9hdmFpbGFibGVFeHBlcmllbmNlcw?external_user_id={external_user_id}&account_id=apn_xxxxxxx" \
-H "Authorization: Bearer {access_token}" \
-H "x-pd-environment: production"SDK
Run Intuiface actions from your backend
Connect a user's Intuiface account once, then run List Available Experiences 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: "intuiface-available-experiences",
externalUserId: "{external_user_id}", // any stable ID for this user in your system
configuredProps: {
intuiface: { authProvisionId: "apn_xxxxxxx" },
experienceNames: ["Experience Names"],
experienceIds: ["Experience IDs"],
},
})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="intuiface-available-experiences",
external_user_id="{external_user_id}", # any stable ID for this user in your system
configured_props={
"intuiface": {"authProvisionId": "apn_xxxxxxx"},
"experienceNames": ["Experience Names"],
"experienceIds": ["Experience IDs"],
},
)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": "intuiface-available-experiences",
"configured_props": {
"intuiface": { "authProvisionId": "apn_xxxxxxx" },
"experienceNames": ["Experience Names"],
"experienceIds": ["Experience IDs"]
}
}'TOOLS
Intuiface actions
On-demand operations your product or agent can configure and run on behalf of a connected user.
-
List Available Experiences
actionGet a list of available experiences that can receive a message. See the docs.Read-onlyv0.0.2 -
List Experience IDs Options
actionRetrieves available options for the Experience IDs field.Read-onlyv0.0.1 -
List Experience Names Options
actionRetrieves available options for the Experience Names field.Read-onlyv0.0.1 -
List Player Device Names Options
actionRetrieves available options for the Player Device Names field.Read-onlyv0.0.1 -
List Player IDs Options
actionRetrieves available options for the Player IDs field.Read-onlyv0.0.1 -
Send Message
actionSend messages to any connected Intuiface Player running an experience that embeds the Web Triggers Interface Asset. See the docs.Writev0.0.3
EVENTS
Intuiface triggers
Event sources your backend can deploy for users and receive through a webhook.
No Intuiface triggers are available yet.
- App slug
- intuiface
- Authentication
- API key
- Categories
- Business Management
- Actions
- 6
- Triggers
- 0
- API proxy
- Available