Perplexity with Pipedream
Overview
Section titled “Overview”Pipedream is a workflow automation platform with 3,000+ pre-built app integrations. The Perplexity app lets you authenticate once and then call Perplexity's Agent API and Search endpoints from any Pipedream workflow — whether triggered by an email, a webhook, an RSS feed, a Slack message, a Google Sheets update, or a schedule.
Authentication
Section titled “Authentication”Get your API key
Generate a Perplexity API key from the API portal.
Connect Perplexity in Pipedream
In Pipedream, open any workflow and add the Perplexity app to a step. Click Connect new account and paste your API key. Pipedream stores it securely and references it via
$auth.api_keyin all future steps.
Get API Key
Generate your Perplexity API key from the API portal.
Built-in Action: Create Response
Section titled “Built-in Action: Create Response”The Perplexity app ships a Create Response (Agent API) action that runs an Agent API request — no code required.
- Endpoint:
POST /v1/agent - Inputs: a preset or model, input, tools (
web_search,fetch_url), and optional instructions. - Output: the Agent API response, including
status,output, and usage.
Add it from the step picker by searching Perplexity → Create Response (Agent API).
Custom Code Step
Section titled “Custom Code Step”For new model integrations, use a Pipedream Node.js code step to call the Agent API with your saved Perplexity connection:
import { axios } from "@pipedream/platform";
export default defineComponent({
props: {
perplexity: {
type: "app",
app: "perplexity",
},
},
async run({ steps, $ }) {
return await axios($, {
method: "POST",
url: "https://api.perplexity.ai/v1/agent",
headers: {
Authorization: `Bearer ${this.perplexity.$auth.api_key}`,
"Content-Type": "application/json",
"X-Pplx-Integration": "pipedream/1.0",
},
data: {
preset: "low",
input: "Summarize this week's AI research.",
},
});
},
});You can swap the URL to call any Perplexity API endpoint:
/v1/agent— Agent API with third-party models and presets/search— raw ranked web results/v1/embeddings— vector embeddings
Example Workflows
Section titled “Example Workflows”Common Perplexity-on-Pipedream patterns:
- Customer support automation — incoming email triggers a Perplexity Agent API step that drafts a response, then logs the conversation in a CRM.
- News-feed summarization — new article from an RSS trigger is summarized by Perplexity and posted to a Slack channel with citations.
- Brand monitoring — social media mentions are piped through Perplexity for sentiment analysis and entity extraction, then written to a Google Sheet.
- Daily research digest — a scheduled cron triggers a Perplexity query, and the result is emailed or posted to a chat channel every morning.
Security & Credentials
Section titled “Security & Credentials”Pipedream stores your Perplexity API key encrypted at rest and injects it into every step via the $auth object — your key never appears in step UI or logs. You can rotate the key at any time from your account's Connected Accounts page.
Links & Resources
Section titled “Links & Resources”Pipedream Perplexity App
Official Perplexity app on Pipedream.
Pipedream Docs
Full Pipedream documentation.
Perplexity API Reference
Full Perplexity API reference.
Agent API Models
Compare the models available through the Agent API.
Support
Section titled “Support”Need help with the integration?
- Browse the Pipedream documentation
- Review our FAQ