# Nextdoor Conversion API Quick Start Guide

## Nextdoor Conversions API Quick Start Guide

### Destination Info

* Supports [Track](https://documentation.freshpaint.io/developer/freshpaint-sdk-reference#track) calls
* Supports [HIPAA mode](https://documentation.freshpaint.io/hipaa-mode)
* Refer to this destination as **Nextdoor Conversions API** in the [Integrations object](https://documentation.freshpaint.io/reference/developer/freshpaint-sdk-reference#using-the-integrations-object)

Connection Modes:

<table><thead><tr><th width="200.33333333333331" align="right"> </th><th data-type="checkbox">Client-side</th><th data-type="checkbox">Server-side</th></tr></thead><tbody><tr><td align="right">Web</td><td>false</td><td>true</td></tr><tr><td align="right">Mobile</td><td>false</td><td>true</td></tr><tr><td align="right">Server</td><td>false</td><td>true</td></tr></tbody></table>

### Getting Started

This guide enables you to fully enable the Nextdoor Conversions API destination for your site. For more complex events see [our additional documentation](/integrations/destinations/direct-response-ads/nextdoor-conversion-api-early-access/nextdoor-conversion-api-reference.md). Additionally this guide assumes you have the Freshpaint snippet installed on your site; if you do not please follow [ this guide](/readme/guides/quickstart/installing-freshpaint.md).&#x20;

High-level steps:

1. Find/create your Nextdoor **API Token and Pixel ID**
2. Enable the Freshpaint Nextdoor destination
   * If in HIPAA mode enable the required fields
3. Confirm and validate events

### Find your Nextdoor API Token and Pixel ID

{% hint style="success" %}
Nextdoor must grant your account API access before you will be able to create an API token. Please reach out to <ads-api@nextdoor.com> and mention Freshpaint to gain access.
{% endhint %}

#### API Token

1. Log in to your [Nextdoor Ads Manager](https://ads.nextdoor.com/v2)
2. Select **Business settings** from the dropdown in the top right.\
   ![](/files/ixniE0KWqfuIFBxmQ94u)
3. Navigate to **Ads API.** <mark style="color:orange;">You will not be able to see this menu item if you have not been granted API access from Nextdoor.</mark>\
   ![](/files/xisL6G0J5FIuP2tJkqQi)
4. Locate or generate your **API Token** for the Conversions API.\
   ![](/files/YPqdg504fsS7C8SCYbUR)

#### Pixel ID

1. Navigate to **Assets > Pixels** in the top menu.\
   ![](/files/lLqmEf0xzyIHzjUrKgoM)
2. Create a Pixel and the "**Data Source ID**". This is your Pixel ID.\
   ![](/files/i90T5DKzIjwYAlDLcG2h)

### Enable the Freshpaint Nextdoor Conversions API destination

1. Navigate to the [Freshpaint Destinations page](https://app.freshpaint.io/destinations/catalog).
2. Search for the **Nextdoor Conversions API** destination.
3. Select **Configure** to paste your **API Token** and **Pixel ID** from the above steps.
4. Customers that use HIPAA mode should then configure the required, recommended, and recommended view-through properties. You can find all properties that the Freshpaint Nextdoor integration supports here: [Nextdoor Conversion API Reference](/integrations/destinations/direct-response-ads/nextdoor-conversion-api-early-access/nextdoor-conversion-api-reference.md)
5. Enable Nextdoor.

Once you've followed the steps above you can start sending events to Nextdoor Conversions API.

<figure><img src="/files/z7lG225yqJmIINQKgdIb" alt=""><figcaption></figcaption></figure>

### Confirm and validate events

#### Confirm and Validate Conversions in Freshpaint

1. Navigate to your site and visit a page that should trigger your event
2. Trigger your event (Our demonstration event is a `Sign Up`).
3. Navigate to the [Event Verification tool](https://app.freshpaint.io/event-verification).
4. Select `Nextdoor Conversion API` and verify your event went through.
   * This can take up to 90 seconds.
5. Verify the event is marked as `OK` or resolve missing property issues.

#### Confirm and Validate Conversions in Nextdoor

To check whether Nextdoor is receiving events.

1. Log in to your [Nextdoor Ads Manager](https://ads.nextdoor.com/v2)
2. From the top menu select **Assets > Creatives**
3. If you visit your running ads and click one, you should see Clicks and Impressions as non-zero.

<figure><img src="/files/msw3MdHnviELze4NyD3r" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://documentation.freshpaint.io/integrations/destinations/direct-response-ads/nextdoor-conversion-api-early-access/nextdoor-conversion-api-quick-start-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
