> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to Addressfinder

The Addressfinder connector lets your AI agent act in each user's Addressfinder account. Each user connects their own Addressfinder API key and secret once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 17 tools.

**Authentication:** API Key + Secret
**Categories:** CRM & Sales, Developer Tools
**Tools:** 17: 17 read, 0 write, 0 destructive
**Users sign in with:** API key
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=ADDRESSFINDER)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the Addressfinder connection

   In **AgentKit > Connections**, create an Addressfinder connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'addressfinder_au_address_autocomplete',
  toolInput: {
    q: '<q>',
  },
  connector: 'addressfinder',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="addressfinder_au_address_autocomplete",
    tool_input={
        "q": "<q>",
    },
    connection_name="addressfinder",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `addressfinder_au_address_autocomplete`

Autocomplete AU Address · Read-only

Search Australian addresses (GNAF and/or Australia Post PAF) by partial text, for type-ahead address entry.
Returns completions, each with full_address and id.
Use this while a user types. Pass the id from the results to the matching metadata tool for the full address. Use addressfinder_au_address_verify to check a complete address in one call.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `q` (`string`, required): The partial address being searched. Example: 184 Will.
- `ascii` (`string`, optional): Set to 1 to reformat special characters like macrons and other accents characters with their ASCII equivalent (e.g. *Pōneke* and *Café* will be returned as *Poneke* and *Cafe*). Example: 1. One of: `1`.
- `canonical` (`string`, optional): Return canonical and/or alias addresses - this allows for vanity suburbs, historic street names, and more: * 1 - Alias addresses are not included in the search results * Omit to return canonical and alias addresses are returned (most common option). Example: 1. One of: `1`.
- `highlight` (`string`, optional): Returns an additional attribute in the response called highlighted_full_address. This attribute wraps the matching terms in the address with <span class='af_hl'></span> in order to highlight those terms: * 1 - Matching terms in the returned addresses are highlighted. * Omit to not return additional highlighted_full_address property. Example: 1. One of: `1`.
- `max` (`integer`, optional): The maximum number of results to return. The default is 10 results. Example: 10.
- `post_box` (`string`, optional): Return PO Box style addresses. This includes PO Box, Locked Bag, GPO Box, CMB, RMS, Care PO, MS, RSD, Parcel Locker and Parcel Collect. Used with the source filter above: * 0 - Set this option to exclude PO Box style addresses from your search results * 1 - Returns only PO Box style addresses * Omit to return PO Box addresses with deliverable addresses. Example: 0. One of: `0`, `1`.
- `source` (`string`, optional): Determines the source of the addresses being searched and returned. * GNAF - Returns physical addresses from the GNAF address dataset. * PAF - Returns postal addresses, including PO Box type addresses, from the Australia Post postal address file. * GNAF,PAF - Returns addresses from either of the PAF or GNAF address datasets. Defaults to GNAF,PAF. Example: GNAF,PAF. One of: `GNAF,PAF`, `GNAF`, `PAF`.
- `state_codes` (`string`, optional): Comma-separated state or territory codes to filter on: ACT, NSW, NT, QLD, SA, TAS, VIC, WA, OT. Example: NSW,VIC.

Example input: `{"q":"<q>"}`

### `addressfinder_au_address_metadata_get`

Get AU Address Metadata · Read-only

Get the full details of an Australian address selected from autocomplete, by id, GNAF id or DPID.
Returns the structured address (street, locality, state, postcode), identifiers and, when requested, GPS and census areas.
Use after addressfinder_au_address_autocomplete. Supply one of id, gnaf_id or dpid.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `ascii` (`string`, optional): Set to 1 to reformat special characters like macrons and other accents characters with their ASCII equivalent (e.g. *Pōneke* and *Café* will be returned as *Poneke* and *Cafe*). Example: 1. One of: `1`.
- `census` (`integer`, optional): Used to determine which census year’s statistical area identifiers (Meshblock, SA1 & SA2) will be returned in the response. Defaults to 2016 if omitted. Example: 2016. One of: `2016`, `2021`.
- `dpid` (`string`, optional): Australia Post delivery point identifier. You must supply either an id, or a gnaf_id, or a dpid field. Example: 52143012.
- `gnaf_id` (`string`, optional): Unique id from the G-NAF dataset. You must supply either an id, or a gnaf_id, or a dpid field. Example: GANSW704417592.
- `gps` (`string`, optional): Request GPS coordinates for latitude and longitude be returned when available: * 1 - GPS coordinates wil be included in the response * Omit to GPS coordinates. Example: 1. One of: `1`.
- `id` (`string`, optional): Unique address identifier obtained from the Address Autocomplete API. You must supply either an id, or a gnaf_id, or a dpid field. Example: O3uYwEbMVYwdUqDb.
- `source` (`string`, optional): Determines the source of the address and metadata returned.. * GNAF - Returns physical addresses from the GNAF address dataset. * PAF - Returns postal addresses, including PO Box type addresses, from the Australia Post postal address file. * GNAF,PAF - Returns addresses from either of the PAF or GNAF address datasets. Defaults to GNAF,PAF. Example: GNAF,PAF. One of: `GNAF,PAF`, `GNAF`, `PAF`.

Example input: `{}`

### `addressfinder_au_address_verify`

Verify AU Address · Read-only

Verify a complete Australian address, correcting mistakes, against GNAF and/or Australia Post PAF.
Returns matched (true/false) and the verified, structured address with identifiers.
Use this to clean addresses in bulk or on form submit. Use addressfinder_au_address_autocomplete for type-ahead.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `q` (`string`, required): The address to be verified. Example: 274 Harbour Drive, Coffs Harbour NSW 2450.
- `ascii` (`string`, optional): Set to 1 to reformat special characters like macrons and other accents characters with their ASCII equivalent (e.g. *Pōneke* and *Café* will be returned as *Poneke* and *Cafe*). Example: 1. One of: `1`.
- `census` (`integer`, optional): Returns statistical area identifiers (Meshblock, SA1 & SA2) from the specified census year. These attributes are only available from the GNAF database and are not returned if census is omitted. Example: 2016. One of: `2016`, `2021`.
- `extended` (`string`, optional): Returns lga_name, lga_type_code, gnaf_id and legal_parcel_id from the GNAF database. * 1 - Returns additional data available from GNAF. Example: 1. One of: `1`.
- `gnaf` (`string`, optional): Returns physical addresses from the GNAF database. One or both of GNAF or PAF databases need to be selected. * 1 - Queries the GNAF database. Defaults to 1. Example: 1. One of: `1`.
- `gps` (`string`, optional): Returns gps coordinates from the datasource specified (when available). * 1 - Returns latitude and longitude. Example: 1. One of: `1`.
- `paf` (`string`, optional): Returns postal addresses from the PAF database. One or both of GNAF or PAF databases need to be selected. * 1 - queries the AU PAF database. Defaults to 1. Example: 1. One of: `1`.
- `post_box` (`string`, optional): Box type addresses are included by default (only available from PAF database). Box type addresses include PO Box, Locked Bag, GPO Box, CMB, RMS, Care PO, MS, RSD, Parcel Locker and Parcel Collect. Use this attribute to exclude them. * 0 - Excludes Box type addresses from the verification results. Example: 0. One of: `0`.
- `state_codes` (`string`, optional): Comma-separated state or territory codes to filter on: ACT, NSW, NT, QLD, SA, TAS, VIC, WA, OT. Example: NSW,VIC.

Example input: `{"q":"<q>"}`

### `addressfinder_au_location_autocomplete`

Autocomplete AU Location · Read-only

Search Australian streets, suburbs and states by partial text.
Returns completions with full_location and id.
Use this when you need a place rather than a full address. Pass the id to addressfinder_au_location_metadata_get.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `q` (`string`, required): The query string to be matched with the location. Example: Coffs Harb.
- `highlight` (`integer`, optional): Set to 1 to include a highlighted_full_location field in results, wrapping matching terms with <span class='af_hl'></span>. Example: 0. One of: `0`, `1`.
- `location_types` (`string`, optional): A comma-separated list of location types to filter the results. Leave empty to allow any location type. Options are street, locality (suburb), and state. Example: street,locality.
- `max` (`integer`, optional): Maximum number of results to return (1–100). Defaults to 10. Example: 10.
- `state_codes` (`string`, optional): Comma-separated state or territory codes to filter on: ACT, NSW, NT, QLD, SA, TAS, VIC, WA, OT. Example: NSW,VIC.

Example input: `{"q":"<q>"}`

### `addressfinder_au_location_metadata_get`

Get AU Location Metadata · Read-only

Get the details of an Australian street, suburb or state selected from location autocomplete.
Returns the full location, state, postcode and latitude/longitude.
Use after addressfinder_au_location_autocomplete.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): Unique location identifier obtained from the Location Autocomplete API. Example: O3uYwEbMVYwdUqDb.

Example input: `{"id":"<id>"}`

### `addressfinder_email_verify`

Verify Email Address · Read-only

Verify an email address: syntax, domain, mailbox existence and provider.
Returns is_verified, deliverability, not_verified_code and flags for disposable, role, public and catch-all addresses.
Use this before saving or emailing an address. Each verified result counts as a billed lookup.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `email` (`string`, required): The email to be verified. Example: jane.smith@addressfinder.com.
- `features` (`string`, optional): A comma-separated list of parameters that controls the methods of verification to be completed. This will impact the query processing time and data returned in the response. Options: * domain checks if the domain is configured to receive emails; * connection checks if the email account exists; * provider checks and returns the email service provider; * format validates the syntax of the email address only. When format is the only feature, no domain, connection or provider checks are performed, so the response is returned faster and is_verified reflects the format check alone. The is_disposable, is_role, is_public and is_catch_all attributes are returned as null because they are not evaluated. Combining format with any other feature runs a standard verification. Defaults to domain,connection. Example: domain,connection.

Example input: `{"email":"<email>"}`

### `addressfinder_intl_address_autocomplete`

Autocomplete International Address · Read-only

Search addresses in a supported country (for example GB, US, CA, FR, DE, IE, SG) by partial text.
Returns completions with full_address and id.
Use this for countries other than Australia and New Zealand. Pass the id to addressfinder_intl_address_metadata_get.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `country` (`string`, required): ISO 3166 alpha-2 country code in lower case, for example gb, us, ca, fr, de, ie or sg. Example: gb.
- `q` (`string`, required): The partial address being searched. Max length 200 characters. Example: 10 Downing St.
- `max` (`integer`, optional): The maximum number of results to return. Between 1 and 15 (inclusive). Defaults to 10. Example: 10.

Example input: `{"country":"<country>","q":"<q>"}`

### `addressfinder_intl_address_metadata_get`

Get International Address Metadata · Read-only

Get the full details of an international address selected from autocomplete.
Returns the structured address and, when requested, GPS coordinates.
Use after addressfinder_intl_address_autocomplete with the same country.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `country` (`string`, required): ISO 3166 alpha-2 country code in lower case, the same as in autocomplete. Example: gb.
- `id` (`string`, required): Unique address identifier obtained from the Address Autocomplete API. Example: GB|RM|A|12345678.
- `gps` (`integer`, optional): Include GPS coordinates in the results if available (0 or 1). Defaults to 0. Example: 1. One of: `0`, `1`.

Example input: `{"country":"<country>","id":"<id>"}`

### `addressfinder_nz_address_autocomplete`

Autocomplete NZ Address · Read-only

Search New Zealand addresses by partial text, for type-ahead address entry.
Returns completions with a (full address) and pxid.
Use this while a user types. Pass the pxid to addressfinder_nz_address_metadata_get. Use addressfinder_nz_address_verify for complete addresses.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `q` (`string`, required): The partial address being searched. Example: 184 Will.
- `ascii` (`string`, optional): Set to 1 to reformat special characters like macrons and other accents characters with their ASCII equivalent (e.g. *Pōneke* and *Café* will be returned as *Poneke* and *Cafe*). Example: 1. One of: `1`.
- `delivered` (`string`, optional): This filter determines if the results are either delivered or not delivered by NZ Post: * 0 A rarely used option that excludes addresses that NZ Post deliver to. * 1 - Only returns addresses that are delivered to by NZ Post. * Omit to not filter. Returns delivered and non-delivered addresses in the response. Example: 0. One of: `0`, `1`.
- `highlight` (`string`, optional): Returns an additional attribute in the response called highlighted_a. This attribute wraps the matching terms in the address with <span class='af_hl'></span> in order to highlight those terms: * 1 - Highlighted. * Omit to not return additional highlighted_a property. Example: 1. One of: `1`.
- `max` (`integer`, optional): The maximum number of results to return. The default is 10 results. Example: 10.
- `post_box` (`string`, optional): This filter includes/excludes PO Box style addresses. * 0 - Excludes PO Box type addresses from being returned in the response. * 1 - Returns only PO Box, Private Bag, Community Mailbox and Counter Delivery address types. * Omit to not filter. Returns PO Box type and standard addresses in the response. Example: 0. One of: `0`, `1`.
- `region_code` (`string`, optional): Only return addresses within the boundary of the selected region (Regional Authority): * 1 - Only returns addresses from the Auckland Region * 2 - Only returns addresses from the Bay of Plenty Region * 3 - Only returns addresses from the Canterbury Region * 4 - Only returns addresses from the Gisbourne Region * 5 - Only returns addresses from the Hawke's Bay Region * 6 - Only returns addresses from the Manawatu-Wanganui Region * 7 - Only returns addresses from the Marlborough Region * 8 - Only returns addresses from the Nelson Region * 9 - Only returns addresses from the Northland Region * A - Only returns addresses from the Otago Region * B - Only returns addresses from the Southland Region * C - Only returns addresses from the Taranaki Region * D - Only returns addresses from the Tasman Region * E - Only returns addresses from the Waikato Region * F - Only returns addresses from the Wellington Region * G - Only returns addresses from the West Coast Region * H - Only returns addresses from the Chatham Islands Region * Omit to not filter. Returns addresses from all Regions. Example: 1. One of: `1`, `2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `A`, `B`, `C`, `D`, `E`, `F`, `G`, `H`.
- `rural` (`string`, optional): This filter includes/excludes rural/urban addresses: * 0 - Excludes addresses likely to be considered rural by a courier company. * 1 - A rarely used option that returns rural addresses only. * Omit to not filter. Returns rural and urban addresses in the response. Example: 0. One of: `0`, `1`.
- `strict` (`string`, optional): Determines how closely matched the results should be to the q parameter: * 0 - Normal search - Allows some address elements to be omitted but does not allow spelling errors. * 1 - Strict search - Requires all address elements entered in q to be ordered and spelt correctly. * 2 - Fuzzy search - Allows spelling errors and inaccurate address elements. Defaults to 2. Example: 0. One of: `0`, `1`, `2`.

Example input: `{"q":"<q>"}`

### `addressfinder_nz_address_metadata_get`

Get NZ Address Metadata · Read-only

Get the full details of a New Zealand address by pxid or DPID.
Returns the structured address, postal details, coordinates and Statistics NZ areas.
Use after addressfinder_nz_address_autocomplete or addressfinder_nz_address_reverse_geocode. Supply pxid or dpid.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `ascii` (`string`, optional): Set to 1 to reformat special characters like macrons and other accents characters with their ASCII equivalent (e.g. *Pōneke* and *Café* will be returned as *Poneke* and *Cafe*). Example: 1. One of: `1`.
- `census` (`integer`, optional): Desired data source for Statistics NZ metadata. Defaults to 2023. Example: 2018. One of: `2018`, `2023`.
- `dpid` (`string`, optional): Unique reference number assigned to a delivery address by NZ Post. You must supply either a pxid or dpid field. Example: 52143012.
- `pxid` (`string`, optional): Unique address identifier obtained from the NZ Address Autocomplete or NZ Address Bounding Box APIs. You must supply either a pxid or dpid field. Example: 2-.F.1W.p.0F6KG.

Example input: `{}`

### `addressfinder_nz_address_reverse_geocode`

Reverse Geocode NZ Address · Read-only

Find the New Zealand addresses nearest to GPS coordinates, closest first.
Returns completions with address, pxid and distance.
Use this to turn a location into an address. Pass a pxid to addressfinder_nz_address_metadata_get for details.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `x` (`string`, required): Longitude (WGS84). Example: 174.7633.
- `y` (`string`, required): Latitude (WGS84). Example: -36.8485.
- `max` (`integer`, optional): Maximum number of results to return (1–100). Defaults to 10. Example: 10.

Example input: `{"x":"<x>","y":"<y>"}`

### `addressfinder_nz_address_verify`

Verify NZ Address · Read-only

Verify a complete New Zealand address, correcting mistakes.
Returns matched (true/false) and the verified, structured address with identifiers.
Use this to clean addresses on submit or in bulk. Use addressfinder_nz_address_autocomplete for type-ahead.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `q` (`string`, required): The address to be verified. Example: 184 Willis Street, Te Aro, Wellington 6011.
- `ascii` (`string`, optional): Set to 1 to reformat special characters like macrons and other accents characters with their ASCII equivalent (e.g. *Pōneke* and *Café* will be returned as *Poneke* and *Cafe*). Example: 1. One of: `1`.
- `census` (`integer`, optional): Desired data source for Statistics NZ metadata. Defaults to 2023. Example: 2018. One of: `2018`, `2023`.
- `post_box` (`string`, optional): This filter includes/excludes PO Box style addresses. * 0 - Excludes PO Box type addresses from being returned in the response. * 1 - Returns only PO Box, Private Bag, Community Mailbox and Counter Delivery address types. * Omit to not filter. Returns PO Box type and standard addresses in the response. Example: 0. One of: `0`, `1`.
- `region_code` (`string`, optional): Will only match and return an address if exists within the selected region (Regional Authority). Including a region can improve your match success rate as it removes the possibility of matching addresses outside the selected region. * 1 - Only returns addresses from the Auckland Region * 2 - Only returns addresses from the Bay of Plenty Region * 3 - Only returns addresses from the Canterbury Region * 4 - Only returns addresses from the Gisbourne Region * 5 - Only returns addresses from the Hawke's Bay Region * 6 - Only returns addresses from the Manawatu-Wanganui Region * 7 - Only returns addresses from the Marlborough Region * 8 - Only returns addresses from the Nelson Region * 9 - Only returns addresses from the Northland Region * A - Only returns addresses from the Otago Region * B - Only returns addresses from the Southland Region * C - Only returns addresses from the Taranaki Region * D - Only returns addresses from the Tasman Region * E - Only returns addresses from the Waikato Region * F - Only returns addresses from the Wellington Region * G - Only returns addresses from the West Coast Region * H - Only returns addresses from the Chatham Islands Region * Omit to not filter. Returns addresses from all Regions. Example: 1. One of: `1`, `2`, `3`, `4`, `5`, `6`, `7`, `8`, `9`, `A`, `B`, `C`, `D`, `E`, `F`, `G`, `H`.

Example input: `{"q":"<q>"}`

### `addressfinder_nz_location_autocomplete`

Autocomplete NZ Location · Read-only

Search New Zealand streets, suburbs, cities and regions by partial text.
Returns completions with the location and pxid.
Use this when you need a place rather than a full address. Pass the pxid to addressfinder_nz_location_metadata_get.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `q` (`string`, required): The query string to be matched with the location. Example: Te Ar.
- `city` (`string`, optional): Set to 0 to exclude cities, 1 to include only cities. Example: 0. One of: `0`, `1`.
- `highlight` (`integer`, optional): Set to 1 to return an attribute highlighted_a which wraps matched text with <span class='af_hl'></span>. Example: 0. One of: `0`, `1`.
- `max` (`integer`, optional): Max results to return (1–100). Defaults to 10. Example: 10.
- `region` (`string`, optional): Set to 0 to exclude regions, 1 to include only regions. Example: 0. One of: `0`, `1`.
- `region_code` (`string`, optional): Restricts results to a region. Valid codes include: Auckland 1, Bay of Plenty 2, Canterbury 3, Gisborne 4, Hawke's Bay 5, Manawatū-Whanganui 6, Marlborough 7, Nelson 8, Northland 9, Otago A, Southland B, Taranaki C, Tasman D, Waikato E, Wellington F, West Coast G, Chatham Islands H. Example: 1.
- `street` (`string`, optional): Set to 0 to exclude streets, 1 to include only streets. Example: 0. One of: `0`, `1`.
- `strict` (`string`, optional): Match strictness: - 0: normal (no spelling errors) - 1: strict (must be ordered and spelled correctly) - 2: fuzzy (allows misspelling). Defaults to 0. Example: 0. One of: `0`, `1`, `2`.
- `suburb` (`string`, optional): Set to 0 to exclude suburbs, 1 to include only suburbs. Example: 0. One of: `0`, `1`.

Example input: `{"q":"<q>"}`

### `addressfinder_nz_location_metadata_get`

Get NZ Location Metadata · Read-only

Get the details of a New Zealand street, suburb, city or region selected from location autocomplete.
Returns coordinates, canonical formatting and LINZ metadata.
Use after addressfinder_nz_location_autocomplete.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `pxid` (`string`, required): Unique address identifier from the Location Autocomplete API. Example: 2-.F.1W.p.0F6KG.

Example input: `{"pxid":"<pxid>"}`

### `addressfinder_nz_poi_autocomplete`

Autocomplete NZ Point of Interest · Read-only

Search New Zealand points of interest (such as airports, hospitals, schools and landmarks) by partial name.
Returns matches with name, address and id.
Pass the id to addressfinder_nz_poi_metadata_get for details.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `q` (`string`, required): The query string to match against POI names and addresses. Example: Wellington Airp.
- `highlight` (`integer`, optional): Set to 1 to include highlighted_name_and_address in results, wrapping matched text with <span class='af_hl'></span>. Example: 0. One of: `0`, `1`.
- `max` (`integer`, optional): Maximum number of results to return (1–100). Defaults to 10. Example: 10.

Example input: `{"q":"<q>"}`

### `addressfinder_nz_poi_metadata_get`

Get NZ Point of Interest Metadata · Read-only

Get the details of a New Zealand point of interest selected from POI autocomplete.
Returns its location, street, region and LINZ and NZ Post data.
Use after addressfinder_nz_poi_autocomplete.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): Unique POI identifier from the autocomplete API. Example: 1234567.

Example input: `{"id":"<id>"}`

### `addressfinder_phone_verify`

Verify Phone Number · Read-only

Verify a phone number: syntax and number range, then a network check for whether it is connected.
Returns is_verified, line type, line status, country and the number in international and national formats.
Use this to clean phone numbers. Set verify_format_only to true to skip the slower network check.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `default_country_code` (`string`, required): The iso2 country code to be used by default when the phone number does not include a country calling code. Example: AU.
- `phone_number` (`string`, required): The phone number to be verified. Example: 0412 345 678.
- `allowed_country_codes` (`string`, optional): Require that the supplied phone number is registered in one of these supplied countries (comma separated using iso2 codes). Example: AU,NZ.
- `mobile_only` (`boolean`, optional): Require that the supplied number is a mobile phone. Defaults to 0. Example: true.
- `timeout` (`number`, optional): Maximum wait time permitted when verifying the number. If exceeded, will return a status of indeterminate. Example: 10.
- `verify_format_only` (`boolean`, optional): Set to true to validate the syntax and number range of the phone number only. The network check for a connection status is skipped, so line_status is not returned and line_type is derived from the number range alone. Defaults to false. Example: true.

Example input: `{"default_country_code":"<default_country_code>","phone_number":"<phone_number>"}`

## Related

Other CRM & Sales connectors ([all 174](/agentkit/connectors/?category=crm-sales)):

- [Salesforce](/agentkit/connectors/salesforce/): Scalekit connector, OAuth, 74 tools
- [HubSpot](/agentkit/connectors/hubspot/): Scalekit connector, OAuth, 457 tools
- [Close](/agentkit/connectors/close/): Scalekit connector, OAuth, 103 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
