Create Contact with Wix API on New Work Order Completed from MaintainX API

Pipedream makes it easy to connect APIs for Wix, MaintainX and 2,000+ other apps remarkably fast.

Trigger workflow on

New Work Order Completed from the MaintainX API

Next, do this

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

Select this integration
Configure the New Work Order Completed trigger
1. Connect your MaintainX account
2. Configure timer
Configure the Create Contact action
1. Connect your Wix account
2. Select a Site
3. Configure Email
4. Optional- Configure First Name
5. Optional- Configure Last Name
6. Configure Phone
7. Optional- Select one or more Labels
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 Work Order Completed on MaintainX

Description:Emit new event each time a new work order is completed.

Version:0.0.1

Key:maintainx-new-work-order-completed

View on GitHub

MaintainX Overview#

The MaintainX API lets you automate workflows related to work orders, assets, and maintenance activities within the MaintainX platform. With this API on Pipedream, you can build serverless workflows to react to events, sync data, and connect MaintainX to other apps and services, creating a seamless integration hub for facility and equipment management tasks.

Trigger Code#

import maintainx from "../../maintainx.app.mjs";
import { DEFAULT_POLLING_SOURCE_TIMER_INTERVAL } from "@pipedream/platform";

export default {
  name: "New Work Order Completed",
  version: "0.0.1",
  key: "maintainx-new-work-order-completed",
  description: "Emit new event each time a new work order is completed.",
  type: "source",
  dedupe: "unique",
  props: {
    maintainx,
    db: "$.service.db",
    timer: {
      type: "$.interface.timer",
      static: {
        intervalSeconds: DEFAULT_POLLING_SOURCE_TIMER_INTERVAL,
      },
    },
  },
  methods: {
    emitEvent(data) {
      if (!data.completedAt) {
        return;
      }

      this._setLastWorkOrderId(data.id);

      this.$emit(data, {
        id: data.id,
        summary: `New work order with ID ${data.id}`,
        ts: Date.parse(data.createdAt),
      });
    },
    _setLastWorkOrderId(id) {
      this.db.set("lastWorkOrderId", id);
    },
    _getLastWorkOrderId() {
      return this.db.get("lastWorkOrderId");
    },
  },
  hooks: {
    async deploy() {
      const { workOrders } = await this.maintainx.getWorkOrders({
        params: {
          limit: 10,
        },
      });

      workOrders.reverse().forEach(this.emitEvent);
    },
  },
  async run() {
    const lastWorkOrderId = this._getLastWorkOrderId();

    let cursor;

    do {
      const {
        nextCursor, workOrders,
      } = await this.maintainx.getWorkOrders({
        params: {
          cursor,
          limit: 100,
        },
      });

      workOrders.reverse().forEach(this.emitEvent);

      if (
        workOrders.length < 100 ||
        workOrders.filter((workOrder) => workOrder.id === lastWorkOrderId)
      ) {
        return;
      }

      cursor = nextCursor;
    } while (cursor);
  },
};

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

Trigger Authentication#

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

To retrieve your API Key,

Navigate to your MaintainX account and sign in
Go to “Settings” > “Integrations”
Click the “API Keys” tab

About MaintainX#

MaintainX is mobile-first work order and procedure digitization software that allows factory frontline teams to know what they need to do and how to do it.

Action#

Create Contact on Wix

Description:Creates a new contact. [See the documentation](https://dev.wix.com/api/rest/contacts/contacts/contacts-v4/create-contact)

Version:0.0.1

Key:wix_api_key-create-contact

View on GitHub

Wix Overview#

The Wix API allows for the management and automation of various aspects of Wix-based web applications. Through Pipedream, you can harness this capability to create, update, retrieve, and delete information from your Wix site, such as managing site content, handling e-commerce orders, and engaging with users. With Pipedream, you can also trigger workflows based on events in Wix, connect with hundreds of other services, and process data with custom logic.

Action Code#

import wix from "../../wix_api_key.app.mjs";

export default {
  key: "wix_api_key-create-contact",
  name: "Create Contact",
  description: "Creates a new contact. [See the documentation](https://dev.wix.com/api/rest/contacts/contacts/contacts-v4/create-contact)",
  version: "0.0.1",
  type: "action",
  props: {
    wix,
    site: {
      propDefinition: [
        wix,
        "site",
      ],
    },
    email: {
      type: "string",
      label: "Email",
      description: "Email address of the new contact",
    },
    firstName: {
      type: "string",
      label: "First Name",
      description: "First name of the new contact",
      optional: true,
    },
    lastName: {
      type: "string",
      label: "Last Name",
      description: "Last name of the new contact",
      optional: true,
    },
    phone: {
      type: "string",
      label: "Phone",
      description: "Phone number of the new contact",
    },
    labels: {
      propDefinition: [
        wix,
        "labels",
        (c) => ({
          siteId: c.site,
        }),
      ],
      default: [],
      optional: true,
    },
  },
  async run({ $ }) {
    const labels = Array.isArray(this.labels)
      ? this.labels
      : JSON.parse(this.labels);
    const response = await this.wix.createContact({
      siteId: this.site,
      data: {
        info: {
          name: {
            first: this.firstName,
            last: this.lastName,
          },
          emails: {
            items: [
              {
                email: this.email,
              },
            ],
          },
          phones: {
            items: [
              {
                phone: this.phone,
              },
            ],
          },
          labelKeys: {
            items: labels,
          },
        },
      },
      $,
    });

    if (response) {
      $.export("$summary", `Successfully created contact with ID ${response.contact.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
Wix	`wix`	`app`	This component uses the Wix app.
Site	`site`	`string`	Select a value from the drop down menu.
Email	`email`	`string`	Email address of the new contact
First Name	`firstName`	`string`	First name of the new contact
Last Name	`lastName`	`string`	Last name of the new contact
Phone	`phone`	`string`	Phone number of the new contact
Labels	`labels`	`string[]`	Select a value from the drop down menu.