Create or Update Customer with Customer.io API on New Recipient Created from Stannp API

Pipedream makes it easy to connect APIs for Customer.io, Stannp and 2,400+ other apps remarkably fast.

Trigger workflow on

New Recipient Created from the Stannp API

Next, do this

Create or Update Customer with the Customer.io 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 Stannp trigger and Customer.io action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Select this integration
Configure the New Recipient Created trigger
1. Connect your Stannp account
2. Configure timer
Configure the Create or Update Customer action
1. Connect your Customer.io account
2. Configure Customer ID
3. Configure Email
4. Optional- Configure Created At
5. Optional- Configure Attributes
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 Recipient Created on Stannp

Description:Emit new event when a new recipient is created.

Version:0.0.1

Key:stannp-new-recipient-created

View on GitHub

Stannp Overview#

The Stannp API integrates with Pipedream to automate direct mail campaigns. You can create, manage, and send personalized postcards, letters, or flyers using Stannp's services. With Pipedream's serverless platform, you can connect Stannp to various triggers and actions, creating workflows that handle everything from customer outreach to event-triggered mailings. This combination is powerful for businesses looking to blend digital and physical marketing strategies seamlessly.

Trigger Code#

import common from "../common/base.mjs";

export default {
  ...common,
  key: "stannp-new-recipient-created",
  name: "New Recipient Created",
  description: "Emit new event when a new recipient is created.",
  version: "0.0.1",
  type: "source",
  dedupe: "unique",
  methods: {
    ...common.methods,
    getSummary(recipient) {
      return `New Recipient: ${recipient.firstname} ${recipient.lastname}`;
    },
    async startEvent(maxResults = 0) {
      const lastId = this._getLastId();

      const response = this.stannp.paginate({
        fn: this.stannp.listRecipients,
      });

      let responseArray = [];

      for await (const item of response) {
        responseArray.push(item);
      }

      responseArray = responseArray.filter((item) => item.id > lastId).reverse();
      if (maxResults && responseArray.length > maxResults) responseArray.length = maxResults;

      if (responseArray.length) this._setLastId(responseArray[0].id);

      for (const item of responseArray.reverse()) {
        this.$emit(item, this.generateMeta(item));
      }
    },
  },
};

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
Stannp	`stannp`	`app`	This component uses the Stannp app.
N/A	`db`	`$.service.db`	This component uses `$.service.db` to maintain state between executions.
	`timer`	`$.interface.timer`

Trigger Authentication#

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

To retrieve your API Key,

Navigate to your Stannp account and sign in
Go to “Settings” > “API Settings”

About Stannp#

Create and send postal Direct Mail campaigns: letters or postcards.

Action#

Create or Update Customer on Customer.io

Description:Creates or update a customer. [See the docs here](https://customer.io/docs/api/#apitrackcustomerscustomers_update)

Version:0.2.0

Key:customer_io-create-or-update-customer

View on GitHub

Customer.io Overview#

Customer.io is a versatile automation tool that allows you to harness the power of email, SMS, and push notifications to create personalized customer experiences. With its comprehensive API, Customer.io enables you to track customer interactions, segment audiences, and trigger targeted communications based on user behavior and data. By leveraging Pipedream, you can easily connect Customer.io to various other services and APIs to automate complex workflows, synthesize data, and respond to events in real-time.

Action Code#

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

export default {
  key: "customer_io-create-or-update-customer",
  name: "Create or Update Customer",
  description: "Creates or update a customer. [See the docs here](https://customer.io/docs/api/#apitrackcustomerscustomers_update)",
  version: "0.2.0",
  type: "action",
  props: {
    app,
    customerId: {
      propDefinition: [
        app,
        "customerId",
      ],
    },
    email: {
      label: "Email",
      type: "string",
      description: "The unique identifier for the customer.",
    },
    created_at: {
      type: "string",
      label: "Created At",
      description: "The UNIX timestamp from when the user was created in your system.",
      optional: true,
    },
    attributes: {
      type: "object",
      label: "Attributes",
      description: "Custom attributes to define the customer.",
      optional: true,
    },
  },
  async run({ $ }) {
    await this.app.createOrUpdateCustomer(this.customerId, {
      email: this.email,
      created_at: this.created_at,
      ...this.attributes,
    }, $);
    $.export("$summary", "Successfully created/updated customer");
  },
};

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
Customer.io	`app`	`app`	This component uses the Customer.io app.
Customer ID	`customerId`	`string`	The unique identifier for the customer.
Email	`email`	`string`	The unique identifier for the customer.
Created At	`created_at`	`string`	The UNIX timestamp from when the user was created in your system.
Attributes	`attributes`	`object`	Custom attributes to define the customer.