---
title: "POST /api/v1/onboarding.hubspot.search"
method: POST
path: "/api/v1/onboarding.hubspot.search"
tags: ["Onboarding V2"]
---

# POST /api/v1/onboarding.hubspot.search

`POST /api/v1/onboarding.hubspot.search`

## Request

- Base URL: `https://api.partly.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.partly.com/api/v1/onboarding.hubspot.search`
- Auth: none declared. Required headers: `authorization`

Search HubSpot companies by name or domain, each with its associated deals (Partly staff only).

## Headers

- `authorization` string, required: UTF-8 encoded string

## Request body

- OnboardingHubspotSearchRequest
  - `limit` integer: 32-bit unsigned integer
  - `query` string, required: UTF-8 encoded string

## Response `200`

200 OK

- OnboardingHubspotSearchResponse
  - `companies` OnboardingHubspotSearchCompany[], required: Expandable array type
    - `deals` OnboardingHubspotSearchDeal[], required: Expandable array type
      - `hubspot_url` string, required: UTF-8 encoded string
      - `id` string, required: UTF-8 encoded string
      - `name` string, required: UTF-8 encoded string
    - `hubspot_url` string, required: UTF-8 encoded string
    - `id` string, required: UTF-8 encoded string
    - `name` string, required: UTF-8 encoded string

## Other responses

- `default`: Error cases

## Changes

- **2026-10-28** `bef981fb5b8a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/partly/apis/core-server/changes/api/v1/onboarding.hubspot.search/post.md)

---

[API](https://skmtc.dev/partly/apis/core-server.md) - [All operations](https://skmtc.dev/partly/apis/core-server/llms.txt) - [OpenAPI document](https://skmtc.dev/partly/apis/core-server/revisions/407d862daeac?raw)