Pipedream Integration

What is the Pipedream Integration?

Pipedream is a developer-first integration platform that combines the power of code with the convenience of pre-built triggers and actions. Unlike our native integrations with Zapier, Make, and Power Automate, Pipedream gives you full Node.js control over your API calls.

This approach is ideal for developers who want more flexibility than visual builders offer. You write JavaScript/TypeScript code to call APIs, handle responses, transform data, and implement custom logic. Pipedream handles the infrastructure - hosting, scaling, monitoring, and secrets management.

While Pipedream doesn't have dynamic inputs like our other integrations, you get something more powerful: the ability to customize every aspect of your API calls, chain multiple APIs with complex logic, and handle edge cases programmatically.

Before You Start

To use APIVerve with Pipedream, you'll need:

• An APIVerve account (any plan, including free)
• A Pipedream account (free tier available)
• Your APIVerve API key from the dashboard
• Basic familiarity with JavaScript/Node.js

Connecting APIVerve to Pipedream

Step 1: Create a New Workflow

Log into Pipedream and click "New" to create a workflow. Choose a trigger - this could be an HTTP webhook, a schedule, or a trigger from another app like GitHub or Slack.

Step 2: Add a Node.js Code Step

Click the "+" to add a step after your trigger. Search for "APIVerve" and select it, or add a generic "Node" code step if you prefer to start from scratch.

Step 3: Connect Your Account

If you selected the APIVerve app, you'll be prompted to connect your account. Click "Connect Account" and enter your API key from the APIVerve dashboard. Pipedream securely stores this as a connected account you can reuse.

Step 4: Write Your Code

Now you can write Node.js code to call any APIVerve API. The simplest approach uses Pipedream's built-in axios helper with your connected account credentials.

Code Examples

Basic API Call

Here's a simple example that validates an email address. The API key is automatically pulled from your connected APIVerve account:

import { axios } from "@pipedream/platform";

export default defineComponent({
  props: {
    apiverve: {
      type: "app",
      app: "apiverve",
    },
  },
  async run({ steps, $ }) {
    const response = await axios($, {
      url: "https://api.apiverve.com/v1/emailvalidator",
      headers: {
        "x-api-key": this.apiverve.$auth.api_key,
      },
      params: {
        email: "[email protected]",
      },
    });
    return response;
  },
});

Dynamic Inputs

Add props to your component to create input fields in the Pipedream UI. This lets you pass data from previous steps or manually enter values:

import { axios } from "@pipedream/platform";

export default defineComponent({
  props: {
    apiverve: {
      type: "app",
      app: "apiverve",
    },
    email: {
      type: "string",
      label: "Email Address",
      description: "The email address to validate",
    },
  },
  async run({ steps, $ }) {
    const response = await axios($, {
      url: "https://api.apiverve.com/v1/emailvalidator",
      headers: {
        "x-api-key": this.apiverve.$auth.api_key,
      },
      params: {
        email: this.email,
      },
    });

    // Access the validation result
    const isValid = response.data?.valid;

    return {
      email: this.email,
      isValid,
      fullResponse: response,
    };
  },
});

Chaining Multiple APIs

One of Pipedream's strengths is chaining API calls with custom logic. This example looks up an IP address, gets the city, then fetches weather for that location:

import { axios } from "@pipedream/platform";

export default defineComponent({
  props: {
    apiverve: {
      type: "app",
      app: "apiverve",
    },
    ipAddress: {
      type: "string",
      label: "IP Address",
      description: "The IP address to look up",
    },
  },
  async run({ steps, $ }) {
    // Step 1: Get location from IP
    const locationResponse = await axios($, {
      url: "https://api.apiverve.com/v1/iplookup",
      headers: {
        "x-api-key": this.apiverve.$auth.api_key,
      },
      params: {
        ip: this.ipAddress,
      },
    });

    const city = locationResponse.data?.city;

    if (!city) {
      return { error: "Could not determine city from IP" };
    }

    // Step 2: Get weather for that location
    const weatherResponse = await axios($, {
      url: "https://api.apiverve.com/v1/weatherforecast",
      headers: {
        "x-api-key": this.apiverve.$auth.api_key,
      },
      params: {
        city: city,
      },
    });

    return {
      ip: this.ipAddress,
      location: locationResponse.data,
      weather: weatherResponse.data,
    };
  },
});

Popular Use Cases

Webhook-Triggered Processing

Receive data via HTTP webhook, process it with APIVerve APIs, and send results elsewhere. For example: receive form submissions, validate emails, enrich with IP data, then POST results to your backend. You have full control over error handling and response formatting.

Scheduled Data Jobs

Run workflows on a cron schedule to process batches of data. Fetch records from a database or API, iterate through them, call appropriate APIVerve APIs, and update your systems with the results. Pipedream handles concurrency and retries.

Event-Driven Automation

Trigger workflows from events in other services. When a new issue is created in GitHub, analyze the sentiment of the description. When a file is uploaded to S3, extract text with OCR. The possibilities are endless when you combine triggers with code.

Custom API Transformations

Build custom endpoints that transform data using APIVerve APIs. Create a webhook that accepts input, calls multiple APIs, transforms the combined results, and returns a custom response format tailored to your application's needs.

Tips for Success

• Use async/await - All Pipedream code runs in an async context, so use await for API calls
• Handle errors - Wrap API calls in try/catch blocks to handle failures gracefully
• Use $.export - Export data between steps using $.export() for cleaner workflows
• Leverage npm packages - Pipedream supports any npm package - import what you need
• Check the response - Always verify the API response status before using the data
• Use environment variables - Store configuration in Pipedream environment variables

Troubleshooting

Authentication Errors

If you get 401 errors, verify your API key is correct in the connected account. You can update it by going to Settings → Connected Accounts in Pipedream and editing your APIVerve connection.

API Errors

Check the response body for detailed error messages. Common issues include missing required parameters, invalid input formats, or rate limiting. Pipedream logs the full response for each step, making debugging straightforward.

Timeout Issues

Pipedream steps have a default timeout. For long-running operations or multiple sequential API calls, you may need to increase the timeout in your step settings or break the workflow into multiple steps.

Additional Resources

• APIVerve on Pipedream - View pre-built actions and triggers
• Integration Overview - More details on the main site
• API Reference - Explore all available APIs
• Making Requests - Detailed API request documentation