View as Markdown
Nextdoor Ads icon

Nextdoor Ads ACTION

Create Ad Group

Creates an ad group based on the input payload for an existing campaign. See the documentation.
  • Action
  • Writes data
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Nextdoor Ads account once, then configure and run Create Ad Group from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "nextdoor-create-ad-group",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    nextdoor: { authProvisionId: "apn_xxxxxxx" },
    advertiserId: "Advertiser ID",
    campaignId: "Campaign ID",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Create Ad Group inputs
Property Type Description
advertiserId Advertiser ID string
The ID of the advertiser.
Required Dynamic
campaignId Campaign ID string
The ID of the campaign.
Required Dynamic
name Name string
The name of the ad group.
Required
placements Placements string[]
The placements for the ad group.
Required
bidAmount Bid Amount string
The bid amount for the ad group. The value must be a string in the format USD 10 as an example.
Required
bidPricingType Bid Pricing Type string
The bid pricing type for the ad group. The value must be one of CPM.
Required
budgetAmount Budget Amount string
The budget amount for the ad group. The value must be a string in the format USD 10 as an example.
Required
startTime Start Time 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.
Required
endTime End Time 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.
Optional
numberOfFrequencyCaps Number Of Frequency Caps integer
The number of frequency caps to be collected. Defaults to 1.
Required

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
nextdoor-create-ad-group
Version
0.0.2
App
Nextdoor Ads
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes