Create Ad Group with Nextdoor Ads API on Task Status Updated from Motion API

Pipedream makes it easy to connect APIs for Nextdoor Ads, Motion and 3,000+ other apps remarkably fast.

Trigger workflow on

Task Status Updated from the Motion API

Next, do this

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

Select this integration
Configure the Task Status Updated trigger
1. Connect your Motion account
2. Configure Polling interval
3. Select a Task Id
Configure the Create Ad Group action
1. Connect your Nextdoor Ads account
2. Select a Advertiser ID
3. Select a Campaign ID
4. Configure Name
5. Select one or more Placements
6. Configure Bid Amount
7. Select a Bid Pricing Type
8. Configure Budget Amount
9. Configure Start Time
10. Optional- Configure End Time
11. Configure Number Of Frequency Caps
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#

Task Status Updated on Motion

Description:Emit new event when the status of a specific task is updated.

Version:0.0.1

Key:motion-task-status-updated

View on GitHub

Motion Overview#

The Motion API empowers users to streamline project management and productivity tasks. Within Pipedream's environment, you can leverage this API to automate actions based on project updates, task completions, and team collaborations. It's a toolset that sails smoothly with Pipedream's knack for creating swift integrations and workflows, making it possible to connect Motion with other apps to optimize project tracking, notifications, and data synchronization.

Trigger Code#

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

export default {
  key: "motion-task-status-updated",
  name: "Task Status Updated",
  version: "0.0.1",
  description: "Emit new event when the status of a specific task is updated.",
  type: "source",
  dedupe: "unique",
  props: {
    motion,
    db: "$.service.db",
    timer: {
      label: "Polling interval",
      description: "Pipedream will poll the Motion API on this schedule",
      type: "$.interface.timer",
      default: {
        intervalSeconds: DEFAULT_POLLING_SOURCE_TIMER_INTERVAL,
      },
    },
    taskId: {
      propDefinition: [
        motion,
        "taskId",
      ],
    },
  },
  methods: {
    _getLastStatusName() {
      return this.db.get("lastStatusName");
    },
    _setLastStatusName(lastStatusName) {
      this.db.set("lastStatusName", lastStatusName);
    },
    async startEvent() {
      const { taskId } = this;
      const lastStatusName = this._getLastStatusName();

      const task = await this.motion.getTask({
        taskId,
      });

      if (lastStatusName != task.status.name) {
        const ts = Date.now();
        this.$emit(
          task,
          {
            id: `${task.id}+${ts}`,
            summary: `The status of the task: "${taskId}" was updated!`,
            ts,
          },
        );

        this._setLastStatusName(task.status.name);
      }
    },
  },
  async run() {
    await this.startEvent();
  },
};

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
Motion	`motion`	`app`	This component uses the Motion 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 Motion API on this schedule
Task Id	`taskId`	`string`	Select a value from the drop down menu.

Trigger Authentication#

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

About Motion#

Manage calendars, meetings, projects & tasks in one tool

Action#

Create Ad Group on Nextdoor Ads

Description:Creates an ad group based on the input payload for an existing campaign. [See the documentation](https://developer.nextdoor.com/reference/adgroup-create).

Version:0.0.2

Key:nextdoor-create-ad-group

View on GitHub

Action Code#

import app from "../../nextdoor.app.mjs";
import utils from "../../common/utils.mjs";

export default {
  key: "nextdoor-create-ad-group",
  name: "Create Ad Group",
  description: "Creates an ad group based on the input payload for an existing campaign. [See the documentation](https://developer.nextdoor.com/reference/adgroup-create).",
  version: "0.0.2",
  annotations: {
    destructiveHint: false,
    openWorldHint: true,
    readOnlyHint: false,
  },
  type: "action",
  props: {
    app,
    advertiserId: {
      propDefinition: [
        app,
        "advertiserId",
      ],
    },
    campaignId: {
      propDefinition: [
        app,
        "campaignId",
        ({ advertiserId }) => ({
          advertiserId,
        }),
      ],
    },
    name: {
      description: "The name of the ad group.",
      propDefinition: [
        app,
        "name",
      ],
    },
    placements: {
      type: "string[]",
      label: "Placements",
      description: "The placements for the ad group.",
      options: [
        "RHR",
        "FEED",
        "FSF",
      ],
    },
    bidAmount: {
      type: "string",
      label: "Bid Amount",
      description: "The bid amount for the ad group. The value must be a string in the format `USD 10` as an example.",
    },
    bidPricingType: {
      type: "string",
      label: "Bid Pricing Type",
      description: "The bid pricing type for the ad group. The value must be one of `CPM`.",
      options: [
        "CPM",
      ],
    },
    budgetAmount: {
      type: "string",
      label: "Budget Amount",
      description: "The budget amount for the ad group. The value must be a string in the format `USD 10` as an example.",
    },
    startTime: {
      propDefinition: [
        app,
        "startTime",
      ],
    },
    endTime: {
      propDefinition: [
        app,
        "endTime",
      ],
    },
    numberOfFrequencyCaps: {
      type: "integer",
      label: "Number Of Frequency Caps",
      description: "The number of frequency caps to be collected. Defaults to `1`.",
      default: 1,
      reloadProps: true,
    },
  },
  methods: {
    frequencyCapsPropsMapper(prefix) {
      const {
        [`${prefix}maxImpressions`]: maxImpressions,
        [`${prefix}numTimeunits`]: numTimeunits,
        [`${prefix}timeunit`]: timeunit,
      } = this;

      return {
        max_impressions: maxImpressions,
        num_timeunits: numTimeunits,
        timeunit,
      };
    },
    getFrequencyCapsPropDefinitions({
      prefix,
      label,
    } = {}) {
      return {
        [`${prefix}maxImpressions`]: {
          type: "integer",
          label: `${label} - Max Impressions`,
          description: "The maximum number of impressions.",
        },
        [`${prefix}numTimeunits`]: {
          type: "integer",
          label: `${label} - Number of Time Units`,
          description: "The number of time units for frequency caps.",
        },
        [`${prefix}timeunit`]: {
          type: "string",
          label: `${label} - Time Unit`,
          description: "The time unit for frequency caps.",
          options: [
            "MINUTE",
            "HOUR",
            "DAY",
            "WEEK",
            "MONTH",
          ],
        },
      };
    },
    createAdGroup(args = {}) {
      return this.app.post({
        path: "/adgroup/create",
        ...args,
      });
    },
  },
  async additionalProps() {
    const {
      numberOfFrequencyCaps,
      getFrequencyCapsPropDefinitions,
    } = this;

    return utils.getAdditionalProps({
      numberOfFields: numberOfFrequencyCaps,
      fieldName: "frequency cap",
      getPropDefinitions: getFrequencyCapsPropDefinitions,
    });
  },
  async run({ $ }) {
    const {
      createAdGroup,
      advertiserId,
      campaignId,
      name,
      placements,
      bidAmount,
      bidPricingType,
      budgetAmount,
      startTime,
      endTime,
      numberOfFrequencyCaps,
      frequencyCapsPropsMapper,
    } = this;

    const response = await createAdGroup({
      $,
      data: {
        advertiser_id: advertiserId,
        campaign_id: campaignId,
        name,
        placements: utils.parseArray(placements),
        bid: {
          amount: bidAmount,
          pricing_type: bidPricingType,
        },
        budget: {
          amount: budgetAmount,
          budget_type: "DAILY_CAP_MONEY",
        },
        start_time: startTime,
        end_time: endTime,
        frequency_caps: utils.getFieldsProps({
          numberOfFields: numberOfFrequencyCaps,
          fieldName: "frequency cap",
          propsMapper: frequencyCapsPropsMapper,
        }),
      },
    });

    $.export("$summary", `Successfully created ad group 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
Nextdoor Ads	`app`	`app`	This component uses the Nextdoor Ads app.
Advertiser ID	`advertiserId`	`string`	Select a value from the drop down menu.
Campaign ID	`campaignId`	`string`	Select a value from the drop down menu.
Name	`name`	`string`	The name of the ad group.
Placements	`placements`	`string[]`	Select a value from the drop down menu:`RHRFEEDFSF`
Bid Amount	`bidAmount`	`string`	The bid amount for the ad group. The value must be a string in the format `USD 10` as an example.
Bid Pricing Type	`bidPricingType`	`string`	Select a value from the drop down menu:`CPM`
Budget Amount	`budgetAmount`	`string`	The budget amount for the ad group. The value must be a string in the format `USD 10` as an example.
Start Time	`startTime`	`string`	The start time in ZonedDateTime format. This date time should be in the future. Eg. `2023-08-03T10:15:30-07:00[America/Los_Angeles]`. See the documentation
End Time	`endTime`	`string`	The end time in ZonedDateTime format. If the End Time is not passed in, then the AdGroup is assumed to be running continuously. Eg. `2023-08-03T10:15:30-07:00[America/Los_Angeles]`. See the documentation
Number Of Frequency Caps	`numberOfFrequencyCaps`	`integer`	The number of frequency caps to be collected. Defaults to `1`.

Try it

Create Advertiser with Nextdoor Ads API on Task Status Updated from Motion API

Motion + Nextdoor Ads

Try it

Create Scheduled Report with Nextdoor Ads API on Task Status Updated from Motion API

Motion + Nextdoor Ads

Try it

Create Campaign with Nextdoor Ads API on Task Status Updated from Motion API

Motion + Nextdoor Ads

Try it

Popular Triggers#

Task Status Updated from the Motion API

Emit new event when the status of a specific task is updated.

Try it

Popular Actions#

Create Task with the Motion API

Create a new task. See the documentation

Try it

Delete Task with the Motion API

Delete a specific task by Id. See the documentation

Try it

Move Workspace with the Motion API

Move a specific task to another workspace. When moving tasks from one workspace to another, the tasks project, status, and label(s) and assignee will all be reset. See the documentation

Try it

Retrieve Schedules with the Motion API

Get a list of schedules for your user. See the documentation

Try it

Retrieve Task with the Motion API

Retrieve a specific task by Id. See the documentation

Try it