Create Ad Group with Nextdoor Ads API on New Event from Teamup API

Pipedream makes it easy to connect APIs for Nextdoor Ads, Teamup and 2,500+ other apps remarkably fast.

Trigger workflow on

New Event from the Teamup 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 Teamup 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 New Event trigger
1. Connect your Teamup account
2. Configure timer
3. Configure Calendar Key
4. Optional- Select one or more Sub-calendars
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#

New Event on Teamup

Description:Emit new event when an event is created on a specified calendar.

Version:0.0.1

Key:teamup-new-event

View on GitHub

Teamup Overview#

The TeamUp API provides an interface to interact with TeamUp's calendar services, allowing for robust management of schedules, events, and calendars. Leveraging this API within Pipedream, you can create automated workflows that handle event synchronization, notifications, and calendar data manipulation. Pipedream's serverless platform facilitates seamless integration with various services to enhance the capabilities of TeamUp, such as triggering actions on a schedule or in response to events, and connecting with other apps like Slack or Google Sheets for extended functionality.

Trigger Code#

import base from "../common/base.mjs";

export default {
  ...base,
  key: "teamup-new-event",
  name: "New Event",
  description: "Emit new event when an event is created on a specified calendar.",
  version: "0.0.1",
  type: "source",
  dedupe: "unique",
  methods: {
    ...base.methods,
    getParams(lastTs) {
      return {
        modifiedSince: lastTs
          ? lastTs
          : Date.parse(this.teamup.getFormattedDate(-29)) / 1000,
      };
    },
    getTsField() {
      return "creation_dt";
    },
    isRelevant({
      event, lastTs,
    }) {
      return Date.parse(event.creation_dt) / 1000 > lastTs;
    },
    generateMeta(event) {
      return {
        id: event.id,
        summary: `New Event - ${event.title}`,
        ts: Date.parse(event.creation_dt),
      };
    },
  },
};

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
Teamup	`teamup`	`app`	This component uses the Teamup app.
N/A	`db`	`$.service.db`	This component uses `$.service.db` to maintain state between executions.
	`timer`	`$.interface.timer`
Calendar Key	`calendarKey`	`string`	Key associated with a calendar. Calendar keys are managed using the Web-based calendar settings application. Look for the Sharing tab.
Sub-calendars	`subCalendarIds`	`string[]`	Select a value from the drop down menu.

Trigger Authentication#

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

About Teamup#

Teamup makes it easy to manage schedules, availability, and events that involve many people and resources. It helps streamline schedule-driven business operations. It’s scalable, customizable, and easy for anyone to use.

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.1

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.1",
  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`.