Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.perplexity.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
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 chat completions 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.
Pipedream supports both no-code visual steps and full-code Node.js / Python steps in the same workflow. Learn more at pipedream.com.

​
Authentication

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.

​
Built-in Action: Chat Completions

The Perplexity app ships a Chat Completions action that generates a model response for a chat conversation with full Perplexity search controls — no code required.
  • Endpoint: POST /v1/chat/completions
  • Inputs: model, messages, search recency, domain filter, etc.
  • Output: full chat completion response including choices[0].message.content and citations.
Add it from the step picker by searching Perplexity → Chat Completions.

​
Custom Code Step

For full control — async chat completions, embeddings, or the Agent API — use a Pipedream Node.js code step that references 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/chat/completions",
      headers: {
        Authorization: `Bearer ${this.perplexity.$auth.api_key}`,
        "Content-Type": "application/json",
        "X-Pplx-Integration": "pipedream/1.0",
      },
      data: {
        model: "sonar-pro",
        messages: [
          { role: "user", content: "Summarize this week's AI research." },
        ],
      },
    });
  },
});
You can swap the URL to call any Perplexity API endpoint:
  • /v1/chat/completions — Sonar chat completions
  • /v1/agent — Agent API with third-party models and presets
  • /search — raw ranked web results
  • /v1/embeddings — vector embeddings
  • /v1/async/chat/completions — async chat completions

​
Example Workflows

Common Perplexity-on-Pipedream patterns:
  • Customer support automation — incoming email triggers a Perplexity Chat Completions 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

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.

Pipedream Perplexity App

Official Perplexity app on Pipedream.

Pipedream Docs

Full Pipedream documentation.

Perplexity API Reference

Full Perplexity API reference.

Perplexity Models

Available Sonar models.

​
Support

Need help with the integration?