Add Contact to a Campaign with Mautic API on New Webhook Event (Instant) from SavvyCal API

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

Trigger workflow on

New Webhook Event (Instant) from the SavvyCal API

Next, do this

Add Contact to a Campaign with the Mautic 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 SavvyCal trigger and Mautic action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Select this integration
Configure the New Webhook Event (Instant) trigger
1. Connect your SavvyCal account
2. Select one or more Webhook Event Types
3. Optional- Configure Shared Secret
Configure the Add Contact to a Campaign action
1. Connect your Mautic account
2. Select a Campaign ID
3. Select a Contact ID
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 Webhook Event (Instant) on SavvyCal

Description:Emit new event when a new webhook event occurs. Please add this Source URL as one of your webhook in [SavvyCal Integration](https://savvycal.com/integrations) > Webhooks.

Version:0.0.1

Key:savvycal-new-webhook-event

View on GitHub

SavvyCal Overview#

SavvyCal makes scheduling meetings less of a hassle with personalized links and overlaying of calendars to find optimal meeting times. The SavvyCal API allows for the automated creation and management of scheduling links, the coordination of calendars, and the customization of scheduling parameters. Within Pipedream, you can integrate SavvyCal with various other apps to streamline your scheduling processes. This means you can automatically create meetings based on triggers from other apps, sync schedules across platforms, or send notifications when new meetings are scheduled.

Trigger Code#

import app from "../../savvycal.app.mjs";
import options from "../../common/options.mjs";
import crypto from "crypto";

export default {
  key: "savvycal-new-webhook-event",
  name: "New Webhook Event (Instant)",
  description: "Emit new event when a new webhook event occurs. Please add this Source URL as one of your webhook in [SavvyCal Integration](https://savvycal.com/integrations) > Webhooks.",
  version: "0.0.1",
  type: "source",
  dedupe: "unique",
  props: {
    app,
    http: "$.interface.http",
    webhookEventTypes: {
      type: "string[]",
      label: "Webhook Event Types",
      description: "The event types to watch for",
      options: options.WEBHOOK_EVENT_TYPES,
    },
    sharedSecret: {
      type: "string",
      label: "Shared Secret",
      description: "The shared secret you configured in the webhook. We highly recommend you to use a secret key to prevent unauthorized access to your webhook.",
      optional: true,
    },
  },
  methods: {
    checkHmac(bodyRaw, hmac) {
      if (!this.sharedSecret || this.sharedSecret === "") {
        console.log("No shared secret configured. Skipping HMAC check.");
        return;
      }

      if (!hmac) {
        throw new Error("Missing HMAC Signature, connection aborted.");
      }

      const expectedSignature = crypto.createHmac("sha256", this.sharedSecret)
        .update(bodyRaw, "utf8")
        .digest("hex");

      if (hmac.toLowerCase() !== `sha256=${expectedSignature}`) {
        throw new Error("Invalid HMAC Signature, connection aborted.");
      }
    },
  },
  async run(event) {
    this.checkHmac(
      event.bodyRaw,
      event.headers["x-savvycal-signature"],
    );

    if (this.webhookEventTypes.indexOf(event.body.type) === -1) {
      console.log("Ignoring event of type", event.body.type);
      return;
    }
    this.$emit(event.body,  {
      summary: `${event.body.type} - ${event.body.id}`,
      id: event.body.id,
      ts: event.body.occurred_at || Date.now(),
    });
  },
};

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
SavvyCal	`app`	`app`	This component uses the SavvyCal 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.
Webhook Event Types	`webhookEventTypes`	`string[]`	Select a value from the drop down menu:`event.createdevent.requestedevent.approvedevent.declinedevent.rescheduledevent.canceledpoll.response.createdworkflow.action.triggered`
Shared Secret	`sharedSecret`	`string`	The shared secret you configured in the webhook. We highly recommend you to use a secret key to prevent unauthorized access to your webhook.

Trigger Authentication#

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

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

About SavvyCal#

The thoughtful way to find a time to meet You’ll love it for the advanced features to keep you in control of your calendar. They’ll love it for the personalized scheduling experience.

Action#

Add Contact to a Campaign on Mautic

Description:Adds a contact to a specific campaign. [See docs](https://developer.mautic.org/#add-contact-to-a-campaign)

Version:0.2.0

Key:mautic-add-contact-to-campaign

View on GitHub

Mautic Overview#

The Mautic API empowers marketers to automate and integrate a wide range of marketing tasks directly into Pipedream workflows. With Mautic's API, you can manage contacts, campaigns, emails, and reports, and use triggers to automate responses based on user behavior. It's a robust tool to align marketing efforts with real-time data and actions, making it possible to personalize communication, streamline follow-ups, and ultimately drive conversions with less manual effort.

Action Code#

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

export default {
  key: "mautic-add-contact-to-campaign",
  name: "Add Contact to a Campaign",
  description: "Adds a contact to a specific campaign. [See docs](https://developer.mautic.org/#add-contact-to-a-campaign)",
  version: "0.2.0",
  type: "action",
  props: {
    mautic,
    campaignId: {
      propDefinition: [
        mautic,
        "campaignId",
      ],
      description: "ID of the campaign to add a contact to",
    },
    contactId: {
      propDefinition: [
        mautic,
        "contactId",
      ],
      description: "ID of the contact being added to the campaign",
    },
  },
  async run({ $ }) {
    const {
      campaignId,
      contactId,
    } = this;

    const response = await this.mautic.addContactToCampaign({
      $,
      campaignId,
      contactId,
    });
    $.export("$summary", "Successfully added contact to campaign");
    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
Mautic	`mautic`	`app`	This component uses the Mautic app.
Campaign ID	`campaignId`	`string`	Select a value from the drop down menu.
Contact ID	`contactId`	`string`	Select a value from the drop down menu.

Action Authentication#

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

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