Hubspot CRM

What this skill does

This skill enables syncing contact records and static lists directly into HubSpot CRM by leveraging HubSpot’s REST API. It handles key operations including searching for contacts by email, creating new contacts with standard properties, generating static contact lists, and batching contacts into those lists efficiently. By automating these steps, it reduces manual data upload overhead and ensures clean, compliant CRM data ingestion using your HubSpot API token.

Who it's for

This skill is ideal for performance marketers managing lead uploads from multiple sources who need to maintain up-to-date contact lists in HubSpot without manual import errors. Growth leads running segmented email campaigns or re-engagement journeys benefit from automating list creation and audience syncing. Agency strategists tasked with integrating client data pipelines into HubSpot will find this skill useful for enforcing property consistency and handling batch operations at scale.

Key workflows

Practitioners typically start by creating a static list in HubSpot to group targeted contacts. Next, they search for each contact’s ID by email to avoid duplicates, then create missing contacts with only standard fields like email and names to ensure API acceptance. Finally, contacts are added to the static list in batches of 100 to comply with HubSpot’s API limits. Throughout, error handling with HTTP responses guides troubleshooting for rejected requests or missing tokens.

Common questions

Can I upload custom contact properties with this skill? Only standard properties like email, firstname, and lastname are supported by default; custom fields require prior confirmation they exist in the HubSpot account. How do I handle contacts already in HubSpot? The skill searches by email first to reuse existing contact IDs, preventing duplicates. What batch size should I use to add contacts to lists? A maximum batch size of 100 contacts per API call is recommended to avoid rate limiting.

How to use in Metaflow

Attach this skill to a Metaflow agent task where you need to automate contact syncing to HubSpot. Set your HUBSPOT_API_TOKEN in the environment beforehand to authenticate calls. When executed, the skill will create or update contacts and manage static lists, providing confirmation logs and URLs for verification. For detailed usage patterns and troubleshooting, refer to the skill’s documentation here.

For broader context, see our roundup of claude marketing skills, and read best Claude skills for marketing agencies for related setup guidance.