Create Contact with Quaderno API on New Click from Cutt.ly API

Pipedream makes it easy to connect APIs for Quaderno, Cutt.ly and 2,000+ other apps remarkably fast.

Trigger workflow on

New Click from the Cutt.ly API

Next, do this

Create Contact with the Quaderno API

No credit card required

▶

Watch us build a workflow

4 min

Watch now ➜

Trusted by 800,000+ developers from startups to Fortune 500 companies

Developers ♥ Pipedream

Getting Started#

This integration creates a workflow with a Cutt.ly trigger and Quaderno action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Select this integration
Configure the New Click trigger
1. Connect your Cutt.ly account
2. Configure timer
3. Configure Shortened URL
Configure the Create Contact action
1. Connect your Quaderno account
2. Select a Kind
3. Optional- Configure Country
4. Optional- Configure City
5. Optional- Configure Region
6. Optional- Configure Street Line 1
7. Optional- Configure Email
8. Optional- Configure Phone Number
9. Optional- Configure Postal Code
10. Optional- Configure Full Name
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 Click on Cutt.ly

Description:Emit new event each time a shortened URL receives a new click.

Version:0.0.1

Key:cutt_ly-new-click

View on GitHub

Cutt.ly Overview#

The Cutt.ly API allows users to shorten URLs, track their performance, and manage link settings. With Pipedream, you can automate these tasks and create workflows that respond to various triggers, like new form submissions, emails, or scheduled timers. Utilize Pipedream's capabilities to connect Cutt.ly with other apps, store and analyze click data, and streamline digital marketing processes.

Trigger Code#

import cuttLy from "../../cutt_ly.app.mjs";
import { DEFAULT_POLLING_SOURCE_TIMER_INTERVAL } from "@pipedream/platform";
import sampleEmit from "./test-event.mjs";

export default {
  key: "cutt_ly-new-click",
  name: "New Click",
  description: "Emit new event each time a shortened URL receives a new click.",
  version: "0.0.1",
  type: "source",
  dedupe: "unique",
  props: {
    cuttLy,
    db: "$.service.db",
    timer: {
      type: "$.interface.timer",
      default: {
        intervalSeconds: DEFAULT_POLLING_SOURCE_TIMER_INTERVAL,
      },
    },
    shortenedUrl: {
      type: "string",
      label: "Shortened URL",
      description: "The URL you want to watch for new clicks",
    },
  },
  methods: {
    _getClicks() {
      return this.db.get("clicks") || 0;
    },
    _setClicks(clicks) {
      this.db.set("clicks", clicks);
    },
    generateMeta(difference) {
      const ts = Date.now();
      return {
        id: ts,
        summary: `${difference} new click${difference === 1
          ? ""
          : "s"}`,
        ts,
      };
    },
  },
  async run() {
    const clicks = this._getClicks();
    const { stats } = await this.cuttLy.callApi({
      params: {
        stats: this.shortenedUrl,
      },
    });
    if (stats.clicks > clicks) {
      const difference = stats.clicks - clicks;
      const meta = this.generateMeta(difference);
      this.$emit(stats, meta);
      this._setClicks(stats.clicks);
    }
  },
  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
Cutt.ly	`cuttLy`	`app`	This component uses the Cutt.ly app.
N/A	`db`	`$.service.db`	This component uses `$.service.db` to maintain state between executions.
	`timer`	`$.interface.timer`
Shortened URL	`shortenedUrl`	`string`	The URL you want to watch for new clicks

Trigger Authentication#

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

About Cutt.ly#

Free URL Shortener & Link Management Platform with Custom URL Shortener and branded short links, Link-in-bio and QR Codes generator.

Action#

Create Contact on Quaderno

Description:Add a new contact to Quaderno. [See the Documentation](https://developers.quaderno.io/api/#tag/Contacts/operation/createContact).

Version:0.0.1

Key:quaderno-create-contact

View on GitHub

Quaderno Overview#

The Quaderno API provides robust capabilities for handling sales tax, VAT, and GST compliance. It allows you to automate tax calculations, create and send invoices, and manage transactions and reports with ease. Integrating the Quaderno API on Pipedream opens up opportunities to streamline your finance operations by connecting to various other services like CRMs, payment gateways, and e-commerce platforms, all while leveraging Pipedream's serverless platform to execute custom logic without managing infrastructure.

Action Code#

import constants from "../../common/constants.mjs";
import app from "../../quaderno.app.mjs";

export default {
  key: "quaderno-create-contact",
  name: "Create Contact",
  description: "Add a new contact to Quaderno. [See the Documentation](https://developers.quaderno.io/api/#tag/Contacts/operation/createContact).",
  type: "action",
  version: "0.0.1",
  props: {
    app,
    kind: {
      type: "string",
      label: "Kind",
      description: "The type of contact. Can be `person` or `company`",
      options: Object.values(constants.CONTACT_TYPE),
      default: constants.CONTACT_TYPE.PERSON,
      reloadProps: true,
    },
    country: {
      propDefinition: [
        app,
        "country",
      ],
    },
    city: {
      propDefinition: [
        app,
        "city",
      ],
    },
    region: {
      propDefinition: [
        app,
        "region",
      ],
    },
    streetLine1: {
      propDefinition: [
        app,
        "streetLine1",
      ],
    },
    email: {
      propDefinition: [
        app,
        "email",
      ],
    },
    phone1: {
      propDefinition: [
        app,
        "phone1",
      ],
    },
    postalCode: {
      propDefinition: [
        app,
        "postalCode",
      ],
    },
    fullName: {
      propDefinition: [
        app,
        "fullName",
      ],
    },
  },
  async additionalProps() {
    if (this.kind === constants.CONTACT_TYPE.PERSON) {
      return {
        firstName: {
          type: "string",
          label: "First Name",
          description: "The contact's first name.",
        },
        lastName: {
          type: "string",
          label: "Last Name",
          description: "The contact's last name.",
          optional: true,
        },
      };
    }
    return {
      firstName: {
        type: "string",
        label: "Bussiness Name",
        description: "The contact's bussiness name.",
      },
      department: {
        type: "string",
        label: "Department",
        description: "If the contact is a `company`, this is the deparment.",
        optional: true,
      },
      contactPerson: {
        type: "string",
        label: "Contact Person",
        description: "If the contact is a `company`, this is its contact person.",
        optional: true,
      },
    };
  },
  methods: {
    createContact(args = {}) {
      return this.app.post({
        path: "/contacts",
        ...args,
      });
    },
  },
  async run({ $: step }) {
    const {
      kind, country, city, region, streetLine1, contactPerson,
      department, email, phone1, postalCode, fullName, firstName,
      lastName,
    } = this;

    const response = await this.createContact({
      step,
      data: {
        kind,
        country,
        city,
        region,
        street_line_1: streetLine1,
        contact_person: contactPerson,
        department,
        email,
        phone_1: phone1,
        postal_code: postalCode,
        full_name: fullName,
        first_name: firstName,
        last_name: lastName,
      },
    });

    step.export("$summary", `Successfully created contact with ID ${response.id}`);

    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
Quaderno	`app`	`app`	This component uses the Quaderno app.
Kind	`kind`	`string`	Select a value from the drop down menu:`personcompany`
Country	`country`	`string`	2-letter ISO country code.
City	`city`	`string`	City/District/Suburb/Town/Village.
Region	`region`	`string`	State/Province/Region.
Street Line 1	`streetLine1`	`string`	Address line 1 (Street address/PO Box).
Email	`email`	`string`	The contact's email address.
Phone Number	`phone1`	`string`	The contact's phone number.
Postal Code	`postalCode`	`string`	ZIP or postal code.
Full Name	`fullName`	`string`	The contact's full name.