Integration

Nextdoor Ads integration

Nextdoor Ads is the API of Nextdoor Ads Manager, for advertising on the Nextdoor neighborhood network. Create and manage advertisers, campaigns, ad groups (bid, budget, placements, schedule, targeting), ads, creatives and uploaded media; build retargeting audiences; look up location, demographic, interest and brand safety targeting; read delivery stats; and create one-off or scheduled reports. Custom audiences built from a customer data file, the Conversions API and Nextdoor's content publishing and search APIs are not exposed. Nextdoor grants Ads API access on application (an API agreement is required); the user then generates an API token, valid one year, in the Ads Manager settings, sent as a Bearer token.

Connect Nextdoor Ads How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in Nextdoor Ads.Built from the 59 Nextdoor Ads tools below, on the connection you add once.

What you can do with Nextdoor Ads

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Ad, 5 operations

archive_adArchive adDELETEArchives an ad and returns its id as archived_id. Archived ads are listed only with includeArchived=true.
create_adCreate adPOSTCreates an ad by attaching a creative (creative_id) to an ad group (adgroup_id), with a name. Returns the new ad.
get_adGet adGETReturns one ad: name, ad group, creative, delivery status and user status, creation and update time.
list_adsList adsGETLists an advertiser's ads, or those under one campaign or ad group (parentId), with ad group, creative and status; archived ones only with includeArchived=true. pageSize 1 to 500; pass page_info.end_cursor as cursor for the next page.
update_adUpdate adPUTChanges an ad's name or the creative it shows (creative_id). Returns the updated ad.

Adgroup, 5 operations

archive_adgroupArchive adgroupDELETEArchives an ad group and returns its id as archived_id. Archived ad groups are listed only with includeArchived=true.
create_adgroupCreate adgroupPOSTCreates an ad group in a campaign: placements, bid, daily or lifetime budget, start and end time, targeting and frequency caps. Unless user_status is DRAFT it is created live and can spend its budget once it has an active ad.
get_adgroupGet adgroupGETReturns one ad group: campaign, bid, budget, placements, start and end time, targeting, frequency caps, delivery status and user status.
list_adgroupsList adgroupsGETLists an advertiser's ad groups, or one campaign's with campaignId: bid, budget, placements, schedule, targeting and status; archived ones only with includeArchived=true. pageSize 1 to 500; pass page_info.end_cursor as cursor for the next page.
update_adgroupUpdate adgroupPUTUpdates an ad group's name, bid, budget, start time, end time, targeting or frequency caps. end_time is an object whose value is a date-time string or null. Returns the updated ad group.

Campaign, 5 operations

archive_campaignArchive campaignDELETEArchives a campaign and returns its id as archived_id. Archived campaigns are listed only with includeArchived=true.
create_campaignCreate campaignPOSTCreates a campaign for an advertiser with a name, an objective (AWARENESS, CONSIDERATION, CONVERSION or LEAD_GENERATION) and an optional sub_objective. Ad groups go inside it (create_adgroup).
get_campaignGet campaignGETReturns one campaign: name, objective and sub-objective, delivery status, user status (ACTIVE, PAUSED or ARCHIVED), start and end time.
list_campaignsList campaignsGETLists an advertiser's campaigns (name, objective, delivery and user status, start and end time); archived ones only with includeArchived=true. pageSize 1 to 500; pass page_info.end_cursor as cursor for the next page.
update_campaignUpdate campaignPUTRenames a campaign; name is the only field this update takes. Returns the updated campaign.

Creative, 5 operations

archive_creativeArchive creativeDELETEArchives a creative and returns its id as archived_id. Archived creatives are listed only with includeArchived=true.
create_creativeCreate creativePOSTCreates a creative from media uploaded with upload_media. placement FEED (image, video or carousel), FSF (For Sale and Free image, with a price) or RHR (right-hand rail image); the fields used depend on the format.
get_creativeGet creativeGETReturns one creative: type, placement, name, business name, headline, body and offer text, price, call to action, image, logo and video URLs, carousel cards, post-click action.
list_creativesList creativesGETLists an advertiser's creatives (type, placement, headline, texts, image or video URLs, call to action); archived ones only with includeArchived=true. pageSize 1 to 500; pass page_info.end_cursor as cursor for the next page.
update_creativeUpdate creativePUTUpdates a creative. type names its format (CAROUSEL, FEED_IMAGE, FSF_IMAGE, RHR_IMAGE or VIDEO) and decides which fields apply. Returns the updated creative.

Stat, 5 operations

get_adgroup_statsGet adgroup statsGETReturns the delivery stats of an ad group for a date window: impressions, clicks, CTR, spend, CPM, CPC, results and conversions by event. startTime and endTime are dates (YYYY-MM-DD); endTime defaults to yesterday and startTime to 7 days before it.
get_ad_statsGet ad statsGETReturns the delivery stats of an ad for a date window: impressions, clicks, CTR, spend, CPM, CPC, results and conversions by event. startTime and endTime are dates (YYYY-MM-DD); endTime defaults to yesterday and startTime to 7 days before it.
get_advertiser_statsGet advertiser statsGETReturns the delivery stats of an advertiser for a date window: impressions, clicks, CTR, spend, CPM, CPC, results and conversions by event. startTime and endTime are dates (YYYY-MM-DD); endTime defaults to yesterday and startTime to 7 days before it.
get_campaign_statsGet campaign statsGETReturns the delivery stats of a campaign for a date window: impressions, clicks, CTR, spend, CPM, CPC, results and conversions by event. startTime and endTime are dates (YYYY-MM-DD); endTime defaults to yesterday and startTime to 7 days before it.
get_creative_statsGet creative statsGETReturns the delivery stats of a creative for a date window: impressions, clicks, CTR, spend, CPM, CPC, results and conversions by event. startTime and endTime are dates (YYYY-MM-DD); endTime defaults to yesterday and startTime to 7 days before it.

Audience, 4 operations

archive_audienceArchive audienceDELETEArchives an audience and returns its id as archived_id. Nextdoor documents this route for custom audiences.
create_audienceCreate audiencePOSTCreates a retargeting audience of people who engaged with the advertiser's ads or whose conversions its pixel or the Conversions API tracked, over a lookback window. Custom audiences from a data file are not supported here.
get_audienceGet audienceGETReturns one audience: name, description, type, status, size and its retargeting settings.
list_audiencesList audiencesGETLists an advertiser's audiences with type, status, size and retargeting settings. pageSize 1 to 500; pass page_info.end_cursor as cursor for the next page.

Media, 4 operations

archive_mediaArchive mediaDELETEArchives a media asset and returns its id as archived_id.
get_mediaGet mediaGETReturns one media asset: type, file name, MIME type, public URL, creation and update time, and its cropped versions.
list_mediaList mediaGETLists an advertiser's uploaded media (logos, images, videos) with id, type, file name, MIME type, public URL and cropped versions. mediaType filters to IMAGE or VIDEO.
upload_mediaUpload mediaPOSTUploads a file to an advertiser's media library: type logo, canvas (an ad image, with placement feed, fsf or rhr) or video. Creatives reference the returned id.

Report, 4 operations

archive_reportArchive reportDELETEArchives a report and returns its id as archived_id.
create_reportCreate reportPOSTStarts a one-off report of chosen metrics broken down by dimensions over a date-time range, optionally filtered and emailed to recipients (CSV or XLSX). get_report returns its status and download_url.
get_reportGet reportGETReturns one report: name, status (STARTED, IN_PROGRESS, COMPLETED, FAILED...), metrics, dimensions, filters, output format and download_url.
list_reportsList reportsGETLists an advertiser's one-off reports with their status (STARTED, IN_PROGRESS, COMPLETED, FAILED...), settings and download_url. pageSize 1 to 500; pass page_info.end_cursor as cursor for the next page.

Schedule, 4 operations

archive_report_scheduleArchive report scheduleDELETEArchives a report schedule and returns its id as archived_id.
create_report_scheduleCreate report schedulePOSTCreates a recurring report: schedule frequency DAILY, WEEKLY, MONTHLY or ON_FORM_SUBMISSION with lookback_days, plus metrics, dimensions, filters, output format and recipient emails.
get_report_scheduleGet report scheduleGETReturns one report schedule: type, frequency, lookback, metrics, dimensions, filters, recipients, timezone and status.
list_report_schedulesList report schedulesGETLists an advertiser's report schedules (recurring reports) with frequency, metrics, dimensions, recipients and status. pageSize 1 to 500; pass page_info.end_cursor as cursor for the next page.

Status, 4 operations

update_adgroup_statusUpdate adgroup statusPUTActivates or pauses an ad group (user_status ACTIVE or PAUSED) and returns the updated ad group. ACTIVE lets it deliver its ads and spend its budget.
update_ad_statusUpdate ad statusPUTTurns an ad on or off (user_status ACTIVE or INACTIVE) and returns the updated ad. An ACTIVE ad in an active ad group delivers and spends that ad group's budget.
update_campaign_statusUpdate campaign statusPUTActivates or pauses a campaign (user_status ACTIVE or PAUSED) and returns the updated campaign. ACTIVE lets its active ad groups deliver ads and spend their budgets.
update_report_schedule_statusUpdate report schedule statusPUTPauses or resumes a report schedule (status ACTIVE or PAUSED) and returns the updated schedule.

Advertiser, 3 operations

create_advertiserCreate advertiserPOSTCreates an advertiser under the token's business profile; the token's user becomes its admin. Takes a name, country (US, CA or GB), currency, timezone, address, business category and website.
get_advertiserGet advertiserGETReturns one advertiser: name, country, currency, timezone, address, business categories, website, payment profile ids, account balance and billing limit.
update_advertiserUpdate advertiserPUTUpdates an advertiser's name, default business name, address, business category, website, web scraping opt-in, billing limit (user_set_billing_limit) or bill-to payment profile.

Country, 2 operations

list_demographic_targetingList demographic targetingGETLists the demographic targeting options of one type (household_income, homeowner, age, gender or device) in a country, with ids and names.
list_targeting_countriesList targeting countriesGETLists the countries ads can target, with their ids: the countryId the other targeting tools take.

Brandsafety, 1 operation

list_brand_safety_targetingList brand safety targetingGETLists the brand safety targeting options available to an advertiser (ids and names).

Business category, 1 operation

list_business_categoriesList business categoriesGETLists Nextdoor's business categories and their subcategories (ids and names), the values create_advertiser and update_advertiser take in business_category.

Generated report, 1 operation

list_generated_reportsList generated reportsGETLists the reports a schedule has generated, each with its status and download_url. pageSize 1 to 500; pass page_info.end_cursor as cursor for the next page.

Interest, 1 operation

list_interest_targetingList interest targetingGETLists the interest targeting options available to an advertiser (ids and names), for an ad group's targeting.interests_targeting.

Match, 1 operation

match_postal_codesMatch postal codesPOSTTurns a list of postal codes (separated by commas, semicolons or newlines) into postal code targeting ids for one country, and lists the codes that matched nothing.

Me, 1 operation

get_meGet meGETReturns the Ads Manager user the token belongs to (id, name, email, locale), each advertiser it can act for with its role, and its business profile. Call it first to find advertiser ids.

Metro, 1 operation

list_targeting_metrosList targeting metrosGETLists the metro areas of a country that ads can target (ids, names and types), for an ad group's location targeting. pageSize 1 to 500; pass page_info.end_cursor as cursor for the next page.

Postalcode, 1 operation

list_targeting_postal_codesList targeting postal codesGETLists the postal codes of a country that ads can target (ids, names and types), for an ad group's location targeting. pageSize 1 to 500; pass page_info.end_cursor as cursor for the next page.

Region, 1 operation

list_targeting_regionsList targeting regionsGETLists the regions of a country that ads can target (ids, names and types), for an ad group's location targeting. pageSize 1 to 500; pass page_info.end_cursor as cursor for the next page.

Use Nextdoor Ads from Claude Code, Cursor or Codex

Connect Nextdoor Ads in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Nextdoor Ads operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect Nextdoor Ads

Create your workspace
Sign up free. Nothing to install.
Connect Nextdoor Ads once
Add your Nextdoor Ads connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.