Email User with AcyMailing API on New Download Counts from npm API

Pipedream makes it easy to connect APIs for AcyMailing, npm and 2,400+ other apps remarkably fast.

Trigger workflow on

New Download Counts from the npm API

Next, do this

Email User with the AcyMailing API

No credit card required

▶

Watch us build a workflow

8 min

Watch now ➜

Trusted by 1,000,000+ developers from startups to Fortune 500 companies

Developers ♥ Pipedream

Getting Started#

This integration creates a workflow with a npm trigger and AcyMailing action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Select this integration
Configure the New Download Counts trigger
1. Connect your npm account
2. Configure timer
3. Select a Period
4. Optional- Configure Package
Configure the Email User action
1. Connect your AcyMailing account
2. Configure Email
3. Optional- Configure Auto Add User
4. Configure Email Id
5. Optional- Configure Track Email
6. Optional- Configure Params
Deploy the workflow
Send a test event to validate your setup
Turn on the trigger

Details#

This integration uses pre-built, source-available components from Pipedream's GitHub repo. These components are developed by Pipedream and the community, and verified and maintained by Pipedream.

To contribute an update to an existing component or create a new component, create a PR on GitHub. If you're new to Pipedream component development, you can start with quickstarts for trigger span and action development, and then review the component API reference.

Trigger#

New Download Counts on npm

Description:Emit new event with the latest count of downloads for an npm package. [See the documentation](https://github.com/npm/registry/blob/main/docs/download-counts.md).

Version:0.1.0

Key:npm-download-counts

View on GitHub

Trigger Code#

import app from "../../npm.app.mjs";

export default {
  key: "npm-download-counts",
  name: "New Download Counts",
  description: "Emit new event with the latest count of downloads for an npm package. [See the documentation](https://github.com/npm/registry/blob/main/docs/download-counts.md).",
  version: "0.1.0",
  type: "source",
  props: {
    app,
    db: "$.service.db",
    timer: {
      type: "$.interface.timer",
      description: "One day interval time is recommended because NPM only update metrics once a day. [See the documentation](https://github.com/npm/registry/blob/main/docs/download-counts.md#data-source).",
      default: {
        intervalSeconds: 60 * 60 * 24,
      },
    },
    period: {
      type: "string",
      label: "Period",
      description: "Select last-day, last-week or last-month.",
      optional: false,
      default: "last-day",
      options: [
        "last-day",
        "last-week",
        "last-month",
      ],
    },
    packageName: {
      type: "string",
      label: "Package",
      description: "Enter an npm package name. Leave blank for all",
      optional: true,
    },
  },
  methods: {
    getDownloadCounts({
      period, packageName, ...args
    } = {}) {
      const basePath = `/downloads/point/${encodeURIComponent(period)}`;
      return this.app.makeRequest({
        path: packageName
          ? `${basePath}/${encodeURIComponent(packageName)}`
          : basePath,
        ...args,
      });
    },
  },
  async run({ timestamp: ts }) {
    const {
      getDownloadCounts,
      period,
      packageName,
    } = this;

    const response = await getDownloadCounts({
      period,
      packageName,
    });

    this.$emit(response, {
      id: ts,
      summary: `New Download Count ${response.downloads}`,
      ts,
    });
  },
};

Trigger Configuration#

This component may be configured based on the props defined in the component code. Pipedream automatically prompts for input values in the UI and CLI.

Label	Prop	Type	Description
npm	`app`	`app`	This component uses the npm app.
N/A	`db`	`$.service.db`	This component uses `$.service.db` to maintain state between executions.
	`timer`	`$.interface.timer`	One day interval time is recommended because NPM only update metrics once a day. See the documentation.
Period	`period`	`string`	Select a value from the drop down menu:`last-daylast-weeklast-month`
Package	`packageName`	`string`	Enter an npm package name. Leave blank for all

Trigger Authentication#

The npm API does not require authentication.

About npm#

Node package manager

Action#

Email User on AcyMailing

Description:Sends an email to a single AcyMailing user. The user must exist in the AcyMailing database. [See the documentation](https://docs.acymailing.com/v/rest-api/emails#send-an-email-to-a-user)

Version:0.0.1

Key:acymailing-email-user

View on GitHub

Action Code#

import acymailing from "../../acymailing.app.mjs";
import { parseObject } from "../../common/utils.mjs";

export default {
  key: "acymailing-email-user",
  name: "Email User",
  description: "Sends an email to a single AcyMailing user. The user must exist in the AcyMailing database. [See the documentation](https://docs.acymailing.com/v/rest-api/emails#send-an-email-to-a-user)",
  version: "0.0.1",
  type: "action",
  props: {
    acymailing,
    email: {
      type: "string",
      label: "Email",
      description: "The email address of the receiver.",
    },
    autoAddUser: {
      type: "boolean",
      label: "Auto Add User",
      description: "Defaults to false. If the email address doesn't match an existing AcyMailing user, one will be automatically created if this option is set to true.",
      optional: true,
    },
    emailId: {
      type: "integer",
      label: "Email Id",
      description: "The mail ID to send. This is not a campaign ID but the mail ID of the table xxx_acym_mail in the database, or the mail_id of a campaign.",
    },
    trackEmail: {
      type: "boolean",
      label: "Track Email",
      description: "Defaults to true. If true, the open/click statistics will be collected for this email.",
      optional: true,
    },
    params: {
      type: "object",
      label: "Params",
      description: "An object of shortcodes and values to replace in the body of the sent email. Example: { \"shortcode1\": \"value 1\" }. If the body of the sent email contains the text \"{shortcode1}\", it will be replaced by \"value 1\" in the sent version.",
      optional: true,
    },
  },
  async run({ $ }) {
    const response = await this.acymailing.sendEmailToUser({
      $,
      data: {
        email: this.email,
        autoAddUser: this.autoAddUser,
        emailId: this.emailId,
        trackEmail: this.trackEmail,
        params: parseObject(this.params),
      },
    });
    $.export("$summary", `Email successfully sent to ${this.email}`);
    return response;
  },
};

Action Configuration#

This component may be configured based on the props defined in the component code. Pipedream automatically prompts for input values in the UI.

Label	Prop	Type	Description
AcyMailing	`acymailing`	`app`	This component uses the AcyMailing app.
Email	`email`	`string`	The email address of the receiver.
Auto Add User	`autoAddUser`	`boolean`	Defaults to false. If the email address doesn't match an existing AcyMailing user, one will be automatically created if this option is set to true.
Email Id	`emailId`	`integer`	The mail ID to send. This is not a campaign ID but the mail ID of the table xxx_acym_mail in the database, or the mail_id of a campaign.
Track Email	`trackEmail`	`boolean`	Defaults to true. If true, the open/click statistics will be collected for this email.
Params	`params`	`object`	An object of shortcodes and values to replace in the body of the sent email. Example: { "shortcode1": "value 1" }. If the body of the sent email contains the text "{shortcode1}", it will be replaced by "value 1" in the sent version.

Action Authentication#

AcyMailing uses API keys for authentication. When you connect your AcyMailing account, Pipedream securely stores the keys so you can easily authenticate to AcyMailing APIs in both code and no-code steps.

About AcyMailing#

AcyMailing is the most complete emailing solution for WordPress and Joomla! Design newsletter or marketing campaigns easily with all our tools.

More Ways to Connect AcyMailing + npm#

Other Popular Integrations#

Add or Update User with AcyMailing API on npm Download Counts from npm API

npm + AcyMailing

Try it

Subscribe User to Lists with AcyMailing API on npm Download Counts from npm API

npm + AcyMailing

Try it

Add or Update User with AcyMailing API on New Package Version from npm API

npm + AcyMailing

Try it

Email User with AcyMailing API on New Package Version from npm API

npm + AcyMailing

Try it

Subscribe User to Lists with AcyMailing API on New Package Version from npm API

npm + AcyMailing

Try it

Popular Triggers#

New Download Counts from the npm API

Emit new event with the latest count of downloads for an npm package. See the documentation.

Try it

New Package Version from the npm API

Emit new event when a new version of an npm package is published. See the documentation

Try it

New Confirmed User from the AcyMailing API

Emit new event when a user confirms their email address.

Try it

New Subscribed User from the AcyMailing API

Emit new event when a user subscribes to a specified list.

Try it

New Unsubscribed User from the AcyMailing API

Emit new event when a user unsubscribes from the specified mailing list.

Try it

Popular Actions#

Add or Update User with the AcyMailing API

Creates a new user or updates an existing user in AcyMailing. If the user exists, will update the user's data with provided information. See the documentation

Try it

Email User with the AcyMailing API

Sends an email to a single AcyMailing user. The user must exist in the AcyMailing database. See the documentation

Try it

Subscribe User to Lists with the AcyMailing API

Subscribes a user to one or more specified lists in AcyMailing. See the documentation

Try it