Add Position with Clockwork Recruiting API on New List Item Added from Checkvist API

Pipedream makes it easy to connect APIs for Clockwork Recruiting, Checkvist and 2,700+ other apps remarkably fast.

Trigger workflow on

New List Item Added from the Checkvist API

Next, do this

Add Position with the Clockwork Recruiting 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 Checkvist trigger and Clockwork Recruiting action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Select this integration
Configure the New List Item Added trigger
1. Connect your Checkvist account
2. Configure timer
3. Select a List ID
Configure the Add Position action
1. Connect your Clockwork Recruiting account
2. Select a Person Id
3. Optional- Configure Title
4. Optional- Configure Start Month
5. Optional- Configure Start Year
6. Optional- Configure End Month
7. Optional- Configure End Year
8. Optional- Select a Company Id
9. Optional- Configure Company 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 List Item Added on Checkvist

Description:Emit new event when a new list item is added in a selected list.

Version:0.0.1

Key:checkvist-new-list-item

View on GitHub

Checkvist Overview#

The Checkvist API allows for the creation and management of tasks and lists in a way that streamlines productivity and enhances organizational workflows. With the API, you can automate task updates, synchronize lists with other platforms, and trigger actions based on task completion. Utilizing Pipedream, these capabilities can be expanded by orchestrating complex workflows that connect Checkvist with a multitude of other apps and services, enabling seamless data flow and event-driven automation.

Trigger Code#

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

export default {
  ...common,
  key: "checkvist-new-list-item",
  name: "New List Item Added",
  description: "Emit new event when a new list item is added in a selected list.",
  version: "0.0.1",
  type: "source",
  dedupe: "unique",
  props: {
    ...common.props,
    listId: {
      propDefinition: [
        common.props.checkvist,
        "listId",
      ],
    },
  },
  methods: {
    ...common.methods,
    getFunction() {
      return this.checkvist.getListItems;
    },
    getArgs() {
      return {
        listId: this.listId,
      };
    },
    getSummary(item) {
      return `New Item: ${item.content}`;
    },
  },
  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
Checkvist	`checkvist`	`app`	This component uses the Checkvist app.
N/A	`db`	`$.service.db`	This component uses `$.service.db` to maintain state between executions.
	`timer`	`$.interface.timer`
List ID	`listId`	`string`	Select a value from the drop down menu.

Trigger Authentication#

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

You can obtain your API Key from your Checkvist user profile page.

About Checkvist#

Task manager and online outliner with outstanding keyboard support, tags, due dates, search/filtering and collaboration.

Action#

Add Position on Clockwork Recruiting

Description:Add a position to a specific person. [See the documentation](https://app.swaggerhub.com/apis-docs/clockwork-recruiting/cw-public-api/3.0.0#/Person%20Positions/post_people__person_id__positions)

Version:0.0.1

Key:clockwork_recruiting-add-person-position

View on GitHub

Clockwork Recruiting Overview#

The Clockwork Recruiting API offers a suite of features tailored for executive search firms and in-house recruiting teams, enabling users to manage candidates, clients, and search projects with ease. By integrating this API with Pipedream, you can automate the recruitment process, sync data between various platforms, and streamline candidate engagement and tracking. Pipedream's serverless platform facilitates the creation of custom workflows using the Clockwork Recruiting API to optimize recruitment operations without manual intervention.

Action Code#

import { ConfigurationError } from "@pipedream/platform";
import app from "../../clockwork_recruiting.app.mjs";

export default {
  key: "clockwork_recruiting-add-person-position",
  name: "Add Position",
  version: "0.0.1",
  description: "Add a position to a specific person. [See the documentation](https://app.swaggerhub.com/apis-docs/clockwork-recruiting/cw-public-api/3.0.0#/Person%20Positions/post_people__person_id__positions)",
  type: "action",
  props: {
    app,
    personId: {
      propDefinition: [
        app,
        "personId",
      ],
    },
    title: {
      type: "string",
      label: "Title",
      description: "The title of the position.",
      optional: true,
    },
    startMonth: {
      type: "integer",
      label: "Start Month",
      description: "The month that the person will start the position.",
      optional: true,
    },
    startYear: {
      type: "integer",
      label: "Start Year",
      description: "The year that the person will start the position.",
      optional: true,
    },
    endMonth: {
      type: "integer",
      label: "End Month",
      description: "The month that the person will leave the position.",
      optional: true,
    },
    endYear: {
      type: "integer",
      label: "End Year",
      description: "The year that the person will leave the position.",
      optional: true,
    },
    companyId: {
      propDefinition: [
        app,
        "companyId",
      ],
      optional: true,
    },
    companyName: {
      type: "string",
      label: "Company Name",
      description: "The name of the company where the position is open. **If `Company Id` is set, this field will be overwritten**",
      optional: true,
    },
  },
  async run({ $ }) {
    const {
      app,
      personId,
      ...data
    } = this;

    if (!Object.entries(data).length) {
      throw new ConfigurationError("At least one field must be provided.");
    }

    const response = await app.createPosition({
      $,
      personId,
      data: {
        position: data,
      },
    });

    $.export("$summary", `Successfully created new position with ID ${response.position?.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
Clockwork Recruiting	`app`	`app`	This component uses the Clockwork Recruiting app.
Person Id	`personId`	`string`	Select a value from the drop down menu.
Title	`title`	`string`	The title of the position.
Start Month	`startMonth`	`integer`	The month that the person will start the position.
Start Year	`startYear`	`integer`	The year that the person will start the position.
End Month	`endMonth`	`integer`	The month that the person will leave the position.
End Year	`endYear`	`integer`	The year that the person will leave the position.
Company Id	`companyId`	`string`	Select a value from the drop down menu.
Company Name	`companyName`	`string`	The name of the company where the position is open. If `Company Id` is set, this field will be overwritten

Action Authentication#

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

To retrieve your API Key, API Secret, and Firm Service Key