# HubSpot

Query and update contacts and leads using agent tools. Review required fields, credential setup and how this connector works in Zild.

Source: https://zild.ai/en-US/docs/apps/zild-admin/connector-hubspot

Query and update contacts and leads using agent tools.

## Where to configure

Open Zild Admin → Integrations → Connectors, find the provider and use Configure or Edit. Enter the data from this guide, enable the connector for the workflow and save.

## Required fields

These requirements are the data needed by the workflow using the connector. Generic saving may accept empty fields that are only required when an operation runs. Saving does not confirm that the provider accepts the credential.



<table class="api-params"><thead><tr><th>Field</th><th>Workflow requirement</th></tr></thead><tbody><tr><td><code>ApiKey</code></td><td>Bearer token with the CRM scopes needed by the workflow.</td></tr></tbody></table>



## How to obtain credentials

- In HubSpot, open Settings → Integrations → Service Keys (or Development → Keys → Service Keys).
- Create a named key with the read/write scopes needed for contacts and leads used by the workflow.
- Copy the token into ApiKey. An existing private app token must also have the scopes required by the operations.

## How it works in Zild

The form and executors require ApiKey. The service uses Bearer authentication; do not use a Developer API Key intended for other platform features. Scopes depend on the tools configured on the agent.

## How to verify the configuration

After saving, use the matching workflow (query, agent, call or processing) to verify access. If it fails, check the credential, permissions and selected provider resource. For limited or legacy types, confirm availability with your administrator before use.

When editing, Zild displays protected credentials as asterisks. Preserve the masked value to keep the current credential or paste a new credential to replace it.

## Official documentation

- [HubSpot: Service Keys](https://developers.hubspot.com/blog/hubspot-service-keys-the-right-api-credential-for-data-integrations)

[Back to Connectors](/en-US/docs/apps/zild-admin/integration)