Update Customer with Formaloo API on New Marketing Webhook (Instant) from SendinBlue API

Pipedream makes it easy to connect APIs for Formaloo, SendinBlue and 2,900+ other apps remarkably fast.

Trigger workflow on

New Marketing Webhook (Instant) from the SendinBlue API

Next, do this

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

Select this integration
Configure the New Marketing Webhook (Instant) trigger
1. Connect your SendinBlue account
2. Configure Description
3. Select one or more Events
Configure the Update Customer action
1. Connect your Formaloo account
2. Select a Customer Code
3. Optional- Configure Full Name
4. Optional- Configure First Name
5. Optional- Configure Last Name
6. Configure Username
7. Configure Email
8. Configure Phone Number
9. Optional- Configure Number Of Tags
10. Optional- Configure Score
11. Optional- Select a Country
12. Optional- Select a State
13. Optional- Select a City
14. Optional- Select a Language
15. Optional- Configure Customer Data
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 Marketing Webhook (Instant) on SendinBlue

Description:Emit new event when triggered by a marketing event

Version:0.0.1

Key:sendinblue-marketing-webhook

View on GitHub

SendinBlue Overview#

The SendinBlue API offers a suite of email marketing tools, including campaign creation, contact list management, and transactional email sending. It's designed for crafting personalized messages, automating marketing workflows, and tracking the performance of email campaigns. With Pipedream, you can harness the power of SendinBlue by automating interactions with other services, reacting to events with custom code, and stitching together complex workflows with minimal effort.

Trigger Code#

import common from "../common-webhook.mjs";
import options from "../../common/options.mjs";

export default {
  ...common,
  key: "sendinblue-marketing-webhook",
  name: "New Marketing Webhook (Instant)",
  description: "Emit new event when triggered by a marketing event",
  version: "0.0.1",
  type: "source",
  dedupe: "unique",
  props: {
    ...common.props,
    description: {
      type: "string",
      label: "Description",
      description: "Description of the webhook.",
    },
    events: {
      type: "string[]",
      label: "Events",
      description: "Events triggering the webhook.",
      options: options.marketingEventOptions,
    },
  },
  methods: {
    ...common.methods,
    getEventNames() {
      return this.events;
    },
    getHookDescription() {
      return this.description;
    },
    getEventType() {
      return "marketing";
    },
    generateMeta(body) {
      const meta = {
        ...body,
      };
      return meta;
    },
  },
};

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
SendinBlue	`sendinBlueApp`	`app`	This component uses the SendinBlue app.
N/A	`http`	`$.interface.http`	This component uses `$.interface.http` to generate a unique URL when the component is first instantiated. Each request to the URL will trigger the `run()` method of the component.
N/A	`db`	`$.service.db`	This component uses `$.service.db` to maintain state between executions.
Description	`description`	`string`	Description of the webhook.
Events	`events`	`string[]`	Select a value from the drop down menu:`spamopenedclickhardBouncesoftBounceunsubscribedlistAdditiondelivered`

Trigger Authentication#

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

Get your API key under SMTP & API

About SendinBlue#

Sendinblue powers advanced email marketing and automation

Action#

Update Customer on Formaloo

Description:Update a specific customer. [See the documentation](https://www.formaloo.com/en/developers/)

Version:0.0.1

Key:formaloo-update-customer

View on GitHub

Formaloo Overview#

The Formaloo API lets you interact with your forms and data on Formaloo. You can create new forms, fetch responses, analyze submissions, and more, right within Pipedream. Pipedream's serverless platform facilitates the automation of these tasks, enabling you to integrate Formaloo with hundreds of other services to streamline workflows, analyze data, and synchronize across platforms.

Action Code#

import formaloo from "../../formaloo.app.mjs";
import { prepareData } from "../common/utils.mjs";

export default {
  key: "formaloo-update-customer",
  name: "Update Customer",
  version: "0.0.1",
  description: "Update a specific customer. [See the documentation](https://www.formaloo.com/en/developers/)",
  type: "action",
  props: {
    formaloo,
    customerId: {
      propDefinition: [
        formaloo,
        "customerId",
      ],
    },
    fullName: {
      propDefinition: [
        formaloo,
        "fullName",
      ],
      optional: true,
    },
    firstName: {
      propDefinition: [
        formaloo,
        "firstName",
      ],
      optional: true,
    },
    lastName: {
      propDefinition: [
        formaloo,
        "lastName",
      ],
      optional: true,
    },
    username: {
      propDefinition: [
        formaloo,
        "username",
      ],
    },
    email: {
      propDefinition: [
        formaloo,
        "email",
      ],
    },
    phoneNumber: {
      propDefinition: [
        formaloo,
        "phoneNumber",
      ],
    },
    numberOfTags: {
      propDefinition: [
        formaloo,
        "numberOfTags",
      ],
      optional: true,
      reloadProps: true,
    },
    score: {
      propDefinition: [
        formaloo,
        "score",
      ],
      optional: true,
    },
    countrySlug: {
      propDefinition: [
        formaloo,
        "countrySlug",
      ],
      optional: true,
    },
    stateSlug: {
      propDefinition: [
        formaloo,
        "stateSlug",
        ({ countrySlug }) => ({
          countrySlug,
        }),
      ],
      optional: true,
    },
    city: {
      propDefinition: [
        formaloo,
        "city",
        ({ stateSlug }) => ({
          stateSlug,
        }),
      ],
      optional: true,
    },
    language: {
      propDefinition: [
        formaloo,
        "language",
      ],
      optional: true,
    },
    customerData: {
      propDefinition: [
        formaloo,
        "customerData",
      ],
      optional: true,
    },
  },
  async additionalProps() {
    return Array.from({
      length: this.numberOfTags,
    }).reduce((acc, _, index) => {
      const pos = index + 1;

      return {
        ...acc,
        [`tagSlug-${pos}`]: {
          type: "string",
          label: `Tag ${pos}`,
          description: "The tag you want to add.",
          options: async ({ page }) => {
            const { data } = await this.formaloo.listTags({
              params: {
                page: page + 1,
              },
            });
            return data?.tags.map(({
              slug: value, title: label,
            }) => ({
              label,
              value,
            }));
          },
        },
      };
    }, {});
  },
  methods: {
    getTag(index) {
      const pos = index + 1;
      const { [`tagSlug-${pos}`]: slug } = this;
      return {
        slug,
      };
    },
    getTags() {
      return Array.from({
        length: this.numberOfTags,
      }).map((_, index) => this.getTag(index));
    },
  },
  async run({ $ }) {
    const {
      formaloo,
      customerId,
      ...data
    } = this;

    const body = prepareData(data);
    const tags = this.getTags();
    if (tags.length) body.tags = tags;

    const response = await formaloo.updateCustomer({
      $,
      customerId,
      data: body,
    });

    $.export("$summary", `A new customer with Id: ${response?.data?.customer?.slug} was successfully created!`);
    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
Formaloo	`formaloo`	`app`	This component uses the Formaloo app.
Customer Code	`customerId`	`string`	Select a value from the drop down menu.
Full Name	`fullName`	`string`	Customer's full name (in case it's not stored as the first name and last name).
First Name	`firstName`	`string`	Customer's first name.
Last Name	`lastName`	`string`	Customer's last name.
Username	`username`	`string`	Any username or identifier on your system which you use to identify the customer.
Email	`email`	`string`	Customer's primary email address.
Phone Number	`phoneNumber`	`string`	Customer's primary phone number.
Number Of Tags	`numberOfTags`	`integer`	The number of tags you want to add.
Score	`score`	`integer`	If you want the customer have an initial score.
Country	`countrySlug`	`string`	Select a value from the drop down menu.
State	`stateSlug`	`string`	Select a value from the drop down menu.
City	`city`	`string`	Select a value from the drop down menu.
Language	`language`	`string`	Select a value from the drop down menu.
Customer Data	`customerData`	`object`	Any data available on the customer in json format.

Action Authentication#

Formaloo uses OAuth authentication. When you connect your Formaloo account, Pipedream will open a popup window where you can sign into Formaloo and grant Pipedream permission to connect to your account. Pipedream securely stores and automatically refreshes the OAuth tokens so you can easily authenticate any Formaloo API.

Pipedream requests the following authorization scopes when you connect your account: