Skip to content
adscapi

Nextdoor CAPI Payload Preview

The server-side request adscapi builds when you track() a purchase and Nextdoor is configured. Secrets and hashed values show as placeholders.

Request

POST
Endpoint
https://ads.nextdoor.com/v2/api/conversions/track
Headers
Authorization: Bearer {NEXTDOOR_TOKEN}
Content-Type: application/json
Body (purchase example)
{
  "event_name": "purchase",
  "action_source": "website",
  "event_time_epoch": 1739452800,
  "event_id": "order_1001",
  "data_source_id": "{NEXTDOOR_PIXEL_ID}",
  "customer": {
    "email": "<sha256(normalized-email)>",
    "phone_number": "<sha256(10-digit-phone)>",
    "client_ip_address": "203.0.113.10",
    "click_id": "ndclid-example-123"
  },
  "custom": {
    "order_value": "USD49.99",
    "order_id": "order_1001"
  }
}

Verified against the library dispatcher (src/dispatchers/nextdoor.ts). See the Nextdoor setup guide for where to get each secret.

Required secrets

NEXTDOOR_TOKENNEXTDOOR_PIXEL_ID

Nextdoor activates when every secret is present. One missing key and the platform no-ops — the rest still receive the event.

Event-name mapping

Canonical eventNextdoor receives
page_viewpage_view
leadlead
signup_startsignup_start (custom event passthrough)
signupsign_up
checkout_createdinitiate_checkout
purchasepurchase
reply_generatedreply_generated (custom event passthrough)
upgrade_clickedupgrade_clicked (custom event passthrough)

Good to know

  • The pixel id goes in the body as data_source_id (required); the token is a Bearer header.
  • PII lives in a flat customer object as single hash strings, not Meta-style arrays like em[].
  • Phone hashes exactly ten digits with no country code; a leading NANP 1 is stripped first.
  • Purchase value is one order_value string: ISO-4217 code plus amount, e.g. USD49.99. event_id is the dedup key against pixel events.

Frequently Asked Questions

Related Tools

Discover more free tools to fix your tracking

Event Payload Playground

Pick a canonical conversion event, fill the fields, and see the exact JSON payload adscapi builds — before you write a line of code.

Try it now

PII Hash Previewer

Type a raw email or phone number and see the normalized value plus its SHA-256 hash — the exact rules adscapi applies per platform. Nothing leaves the browser.

Try it now

Platform Coverage Explorer

Search all 26 ad platforms adscapi dispatches to — support level, required secrets, and setup docs, always in sync with the library registry.

Try it now

Ready to track Nextdoor conversions server-side?

adscapi is free and open source. Set your platform tokens, call track() once, and every configured Conversions API receives the event — hashed the way each platform expects.

Get startednpm install adscapi