Add or Update a contact with SendinBlue API on New Contact in Segment from eSputnik API

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

Trigger workflow on

New Contact in Segment from the eSputnik API

Next, do this

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

Select this integration
Configure the New Contact in Segment trigger
1. Connect your eSputnik account
2. Configure Polling Interval
3. Optional- Configure Max API Requests per Execution
4. Select a Segment
Configure the Add or Update a contact action
1. Connect your SendinBlue account
2. Optional- Select a Contact
3. Configure Email
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 Contact in Segment on eSputnik

Description:Emit new event when a new contact is added in the specified segment

Version:0.0.2

Key:esputnik-new-contact-in-segment

View on GitHub

eSputnik Overview#

The eSputnik API is a powerful tool for managing and automating your email marketing campaigns and other messaging services. Through the API, you can create targeted email sequences, manage contact lists, track email metrics, and dynamically segment your audience based on their interactions. By leveraging Pipedream's capabilities, you can connect eSputnik with hundreds of other apps to synchronize your marketing efforts, automate responses based on customer behavior, and analyze the effectiveness of your campaigns with advanced analytics.

Trigger Code#

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

export default {
  ...common,
  key: "esputnik-new-contact-in-segment",
  name: "New Contact in Segment",
  description: "Emit new event when a new contact is added in the specified segment",
  version: "0.0.2",
  type: "source",
  dedupe: "unique",
  props: {
    ...common.props,
    segment: {
      propDefinition: [
        common.props.esputnik,
        "segment",
      ],
    },
  },
  methods: {
    ...common.methods,
    generateMeta(contact) {
      return this.generateContactMeta(contact);
    },
  },
  async run() {
    const contacts = await this.getPaginatedContacts(this.esputnik.listSegmentContacts.bind(this), {
      params: {
        orderByTs: true,
        asc: false,
      },
      segmentId: this.segment,
    });
    for await (const contact of contacts) {
      const meta = this.generateMeta(contact);
      this.$emit(contact, 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
eSputnik	`esputnik`	`app`	This component uses the eSputnik app.
N/A	`db`	`$.service.db`	This component uses `$.service.db` to maintain state between executions.
Polling Interval	`timer`	`$.interface.timer`	Pipedream will poll the eSputnik API on this schedule
Max API Requests per Execution	`maxRequests`	`integer`	The maximum number of API requests to make per execution (e.g., multiple requests are required to retrieve paginated results).
Segment	`segment`	`string`	Select a value from the drop down menu.

Trigger Authentication#

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

You can get your API Key from your eSputnik account in Profile > Settings > API.

About eSputnik#

Communicate with customers through the most convenient channel for them: email, SMS, Viber, web and mobile push notifications, or combine several channels at once.

Action#

Add or Update a contact on SendinBlue

Description:Add or Update a contact

Version:0.0.1

Key:sendinblue-add-or-update-contact

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.

Action Code#

import sendinBlueApp from "../../sendinblue.app.mjs";

export default {
  key: "sendinblue-add-or-update-contact",
  name: "Add or Update a contact",
  description: "Add or Update a contact",
  version: "0.0.1",
  type: "action",
  props: {
    sendinBlueApp,
    providedIdentifier: {
      type: "string",
      label: "Contact",
      description: "Email OR ID of the contact, if not present the contact will be inserted, it will be used to search the contact, if it can be found the contact will be updated else it will be inserted",
      optional: true,
      reloadProps: true,
      async options({ prevContext }) {
        return this.sendinBlueApp.getContactsPaginated(prevContext, false);
      },
    },
    email: {
      type: "string",
      label: "Email",
      description: "To either be inserted or updated",
    },
  },
  async additionalProps() {
    const attributesList = await this.sendinBlueApp.getContactAttributes(this);
    const attributesFields = attributesList.attributes
      .filter((attr) => attr.category === "normal")
      .reduce((acc, actual) => {
        acc[`attribute-${actual.name}`] = {
          type: "string",
          label: actual.name.replace(/(^\w|\s\w)(\S*)/g, (_, m1, m2) => m1.toUpperCase() + m2.toLowerCase()),
          description: "To either be inserted or updated",
          optional: true,
        };
        return acc;
      }, {});
    const dynamicProps = {
      ...attributesFields,
      listIds: {
        type: "string[]",
        label: "Lists",
        description: "Array with ids of each list to be either inserted or updated,\n\n**On update the contact will be removed from previous lists**",
        options: async ({ prevContext }) => {
          return this.sendinBlueApp.getListsPaginated(prevContext);
        },
      },
    };
    return dynamicProps;
  },
  async run({ $ }) {
    let identifier = this.providedIdentifier;
    const listIds = Object.keys(this.listIds).map((key) => parseInt(this.listIds[key], 10));
    let contact = null;
    if (identifier) {
      contact = await this.sendinBlueApp.existingContactByIdentifier(
        $,
        encodeURIComponent(identifier),
      );
    }

    const attributes = {
      EMAIL: this.email,
    };
    for (let key of Object.keys(this).filter((k) => k.startsWith("attribute-"))) {
      const attribute = this[key];
      if (attribute) {
        attributes[key.replace("attribute-", "")] = attribute;
      }
    }
    $.export("Defined attributes", attributes);

    if (contact) {
      identifier = contact.id;
      const unlinkListIds = contact.listIds.filter((el) => !listIds.includes(el));
      await this.sendinBlueApp.updateContact(
        $,
        identifier,
        attributes,
        listIds,
        unlinkListIds,
      );
      $.export("$summary", `Successfully updated contact "${identifier}"`);
    } else {
      const inserted = await this.sendinBlueApp.addContact(
        $,
        attributes,
        listIds,
      );
      identifier = inserted.id;
      $.export("$summary", `Successfully inserted contact "${identifier}"`);
    }
    return this.sendinBlueApp.existingContactByIdentifier(
      $,
      encodeURIComponent(identifier),
    );
  },
};

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
SendinBlue	`sendinBlueApp`	`app`	This component uses the SendinBlue app.
Contact	`providedIdentifier`	`string`	Select a value from the drop down menu.
Email	`email`	`string`	To either be inserted or updated

Try it

Create Contact with eSputnik API on New Transactional Webhook (Instant) from SendinBlue API

SendinBlue + eSputnik

Try it

Send Event with eSputnik API on New Marketing Webhook (Instant) from SendinBlue API

SendinBlue + eSputnik

Try it

Send Event with eSputnik API on New Transactional Webhook (Instant) from SendinBlue API

SendinBlue + eSputnik

Try it

Subscribe Contact with eSputnik API on New Marketing Webhook (Instant) from SendinBlue API

SendinBlue + eSputnik

Try it

Popular Triggers#

New Contact from the eSputnik API

Emit new event when a new contact is added

Try it

New Contact in Segment from the eSputnik API

Emit new event when a new contact is added in the specified segment

Try it

New Marketing Webhook (Instant) from the SendinBlue API

Emit new event when triggered by a marketing event

Try it

New Transactional Webhook (Instant) from the SendinBlue API

Emit new event when triggered by a transactional event

Try it

Popular Actions#

Create Contact with the eSputnik API

Create a new contact in eSputnik. See the docs here

Try it

Send Event with the eSputnik API

Send an event in eSputnik. See the docs here

Try it

Subscribe Contact with the eSputnik API

Create a new unverified contact in eSputnik. For use with double opt-in implementation. User will need to verify the email to confirm their subscription. See the docs here

Try it

Update Contact with the eSputnik API

Update an existing contact in eSputnik. See the docs here

Try it

Add or Update a contact with the SendinBlue API

Add or Update a contact

Try it