Skip to main content
POST
Builds a sample record from a proposed field mapping and upserts it directly into HubSpot, to validate the configuration before it’s saved. This is stateless — it does not create or persist a webhook; the webhook is only created once you separately call List / create webhooks with type: "hubspot".
Requires the account’s INTEGRATION_HUBSPOT quota.
integer
required
HubSpot connection id, from List HubSpot connections.
string
default:"contact"
One of contact, company, deal, ticket.
array
required
Non-empty list of {"hubspot_property": "..."} mappings — the properties to populate on the test record. Properties not valid for object_type, or internal/read-only ones, are silently skipped; if every mapped property gets skipped, the request fails with 400.
404 if connection_id isn’t owned by this account. 400 if the connection isn’t currently active, or if field_map is empty.

Authorizations

Authorization
string
header
required

Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: 401f7ac837da42b97f613d789819ff93537bee6a. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. api.scanova.io) — the same key sent to the regular API host will not authenticate.

Response

Test result.