Add Information to Cart with Afosto API on Subscriber Created from Flodesk API

Pipedream makes it easy to connect APIs for Afosto, Flodesk and 2,800+ other apps remarkably fast.

Trigger workflow on

Subscriber Created from the Flodesk API

Next, do this

Add Information to Cart with the Afosto 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 Flodesk trigger and Afosto action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Select this integration
Configure the Subscriber Created trigger
1. Connect your Flodesk account
Configure the Add Information to Cart action
1. Connect your Afosto account
2. Configure Cart ID
3. Optional- Configure Email
4. Optional- Configure Is Guest
5. Optional- Configure Given Name
6. Optional- Configure Additional Name
7. Optional- Configure Family Name
8. Optional- Configure Organisation Name
9. Optional- Configure Organisation Is Guest
10. Optional- Configure Organisation Email
11. Optional- Configure Organisation Country Code
12. Optional- Configure Organisation Number
13. Optional- Configure Phone Number Country Code
14. Optional- Configure Phone Number
15. Configure Shipping Address Data
16. Configure Billing Address 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#

Subscriber Created on Flodesk

Description:Emit new event when a subscriber is created in Flodesk. [See the documentation](https://developers.flodesk.com/#tag/webhook-event/operation/subscriber.created)

Version:0.0.1

Key:flodesk-subscriber-created

View on GitHub

Flodesk Overview#

The Flodesk API on Pipedream allows you to streamline email marketing efforts by enabling automation of subscriber management and email campaign triggers. With this integration, you can create workflows to sync subscriber data, send personalized emails based on customer actions, and analyze campaign performance, all in a serverless environment. Pipedream's ability to connect with hundreds of apps opens the door to craft custom automation sequences that fit your specific marketing needs.

Trigger Code#

import common from "../common/base.mjs";
import sampleEmit from "./test-event.mjs";

export default {
  ...common,
  key: "flodesk-subscriber-created",
  name: "Subscriber Created",
  description: "Emit new event when a subscriber is created in Flodesk. [See the documentation](https://developers.flodesk.com/#tag/webhook-event/operation/subscriber.created)",
  version: "0.0.1",
  type: "source",
  dedupe: "unique",
  methods: {
    ...common.methods,
    getEvents() {
      return [
        "subscriber.created",
      ];
    },
    generateMeta(event) {
      return {
        id: event.subscriber.id,
        summary: `New Subscriber ${event.subscriber.id}`,
        ts: Date.parse(event.event_time),
      };
    },
  },
  sampleEmit,
};

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

Trigger Authentication#

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

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

all

About Flodesk#

Flodesk is the world's most intuitive email marketing platform designed to help small businesses grow, nurture and monetize their list while staying beautifully on-brand

Action#

Add Information to Cart on Afosto

Description:Add customer information to a cart. [See the documentation](https://afosto.com/docs/developers/storefront-js-client/custom-checkout/collecting-customer-data/)

Version:0.0.1

Key:afosto-add-information-to-cart

View on GitHub

Action Code#

import { ConfigurationError } from "@pipedream/platform";
import app from "../../afosto.app.mjs";
import { parseObject } from "../../common/utils.mjs";

export default {
  key: "afosto-add-information-to-cart",
  name: "Add Information to Cart",
  description: "Add customer information to a cart. [See the documentation](https://afosto.com/docs/developers/storefront-js-client/custom-checkout/collecting-customer-data/)",
  version: "0.0.1",
  type: "action",
  props: {
    app,
    cartId: {
      propDefinition: [
        app,
        "cartId",
      ],
    },
    email: {
      type: "string",
      label: "Email",
      description: "The email of the customer",
      optional: true,
    },
    isGuest: {
      type: "boolean",
      label: "Is Guest",
      description: "Whether the customer is a guest",
      optional: true,
    },
    givenName: {
      type: "string",
      label: "Given Name",
      description: "The given name of the customer",
      optional: true,
    },
    additionalName: {
      type: "string",
      label: "Additional Name",
      description: "The additional name of the customer",
      optional: true,
    },
    familyName: {
      type: "string",
      label: "Family Name",
      description: "The family name of the customer",
      optional: true,
    },
    organisationName: {
      type: "string",
      label: "Organisation Name",
      description: "The name of the organisation",
      optional: true,
    },
    organisationIsGuest: {
      type: "boolean",
      label: "Organisation Is Guest",
      description: "Whether the organisation is a guest",
      optional: true,
    },
    organisationEmail: {
      type: "string",
      label: "Organisation Email",
      description: "The email of the organisation",
      optional: true,
    },
    organisationCountryCode: {
      type: "string",
      label: "Organisation Country Code",
      description: "The country code of the organisation",
      optional: true,
    },
    organisationNumber: {
      type: "string",
      label: "Organisation Number",
      description: "The number of the organisation",
      optional: true,
    },
    countryCode: {
      type: "string",
      label: "Phone Number Country Code",
      description: "The country code of the phone number",
      optional: true,
    },
    number: {
      type: "string",
      label: "Phone Number",
      description: "The number of the phone number",
      optional: true,
    },
    shippingAddressData: {
      type: "object",
      label: "Shipping Address Data",
      description: "The shipping address data. **E.g. {\"country_code\": \"US\", \"postal_code\": \"10001\", \"address_line_1\": \"123 Main St\", \"given_name\": \"John\", \"family_name\": \"Smith\", \"organisation\": \"Organization Name\"}** [See the documentation](https://afosto.com/docs/developers/storefront-js-client/custom-checkout/collecting-customer-data/)",
    },
    billingAddressData: {
      type: "object",
      label: "Billing Address Data",
      description: "The billing address data. **E.g. {\"country_code\": \"US\", \"postal_code\": \"10001\", \"address_line_1\": \"123 Main St\", \"given_name\": \"John\", \"family_name\": \"Smith\", \"organisation\": \"Organization Name\"}** [See the documentation](https://afosto.com/docs/developers/storefront-js-client/custom-checkout/collecting-customer-data/)",
    },
  },
  async run({ $ }) {
    const cartId = this.cartId;

    const phoneNumberData = {
      country_code: this.countryCode,
      number: this.number,
    };

    const parsedBillingAddressData = parseObject(this.billingAddressData);

    const variables = {
      customerInput: {
        cart_id: cartId,
        customer: {
          contact: {
            email: this.email,
            is_guest: this.isGuest,
            given_name: this.givenName,
            additional_name: this.additionalName,
            family_name: this.familyName,
            phone_numbers: [
              phoneNumberData,
            ],
          },
          organisation: {
            name: this.organisationName,
            is_guest: this.organisationIsGuest,
            administration: {
              email: this.organisationEmail,
            },
            registration: {
              country_code: this.organisationCountryCode,
              number: this.organisationNumber,
            },
          },
        },
      },
      phoneNumberInput: {
        cart_id: cartId,
        phone_number: phoneNumberData,
      },
      shippingAddressInput: {
        address: parseObject(this.shippingAddressData),
        cart_id: cartId,
        type: "ADDRESS",
      },
      billingAddressInput: {
        address: parsedBillingAddressData,
        cart_id: cartId,
      },
      countryCode: parsedBillingAddressData?.country_code,
      postalCode: parsedBillingAddressData?.postal_code,
    };

    const response = await this.app.addInformationToCart({
      $,
      variables,
    });

    if (response.errors) {
      throw new ConfigurationError(JSON.stringify(response.errors[0]));
    }

    $.export("$summary", `Successfully added information to cart with ID: ${this.cartId}`);
    return response.data;
  },
};

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
Afosto	`app`	`app`	This component uses the Afosto app.
Cart ID	`cartId`	`string`	The ID of the cart
Email	`email`	`string`	The email of the customer
Is Guest	`isGuest`	`boolean`	Whether the customer is a guest
Given Name	`givenName`	`string`	The given name of the customer
Additional Name	`additionalName`	`string`	The additional name of the customer
Family Name	`familyName`	`string`	The family name of the customer
Organisation Name	`organisationName`	`string`	The name of the organisation
Organisation Is Guest	`organisationIsGuest`	`boolean`	Whether the organisation is a guest
Organisation Email	`organisationEmail`	`string`	The email of the organisation
Organisation Country Code	`organisationCountryCode`	`string`	The country code of the organisation
Organisation Number	`organisationNumber`	`string`	The number of the organisation
Phone Number Country Code	`countryCode`	`string`	The country code of the phone number
Phone Number	`number`	`string`	The number of the phone number
Shipping Address Data	`shippingAddressData`	`object`	The shipping address data. E.g. {"country_code": "US", "postal_code": "10001", "address_line_1": "123 Main St", "given_name": "John", "family_name": "Smith", "organisation": "Organization Name"} See the documentation
Billing Address Data	`billingAddressData`	`object`	The billing address data. E.g. {"country_code": "US", "postal_code": "10001", "address_line_1": "123 Main St", "given_name": "John", "family_name": "Smith", "organisation": "Organization Name"} See the documentation