Skip to main content
Perplexity

Search documentation

Type to search this documentation.

On this pageOverview

Perplexity with Pipedream

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.

  1. Get your API key

    Generate a Perplexity API key from the API portal.

  2. 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_key in all future steps.

Get API Key

Generate your Perplexity API key from the API portal.

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).

For new model integrations, use a Pipedream Node.js code step to call the Agent API with your saved Perplexity connection:

JavaScript
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

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.

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.

Need help with the integration?

Suggest an edit

Propose a replacement for this page. The site team reviews it before applying any changes.

Export
Documentation menu