hubspot-list-contacts_skill

Overview

This skill lists contacts from HubSpot CRM and returns a paginated contact list with key fields like email, name, phone, company, and contact ID. It is designed for quick retrieval of recent contacts or for browsing large contact sets with cursor-based pagination. Results are formatted for easy display and follow HubSpot API conventions.

How this skill works

The skill calls the HubSpot Contacts API to fetch contact records and returns results along with paging cursors for subsequent requests. Each contact includes id, properties (email, firstname, lastname, phone, company) and a link to the HubSpot record. It supports limit and after (cursor) parameters to control page size and pagination. The skill performs a config check before operation to ensure credentials and scopes are valid.

When to use it

• Quickly view a list of recent contacts in HubSpot
• Bulk-browsing contacts with pagination for outreach or review
• Confirm contact details (email, phone, company) before follow-up
• Integrate into workflows that need a contact roster or directory

Best practices

• Run the configuration check before first use to verify tokens and required scopes
• Request a reasonable limit (default 10) to avoid hitting rate limits
• Use the returned paging.after cursor to fetch the next page reliably
• Handle common HTTP errors: 401 (invalid token), 403 (missing crm.objects.contacts.read scope), 429 (rate limited)

Example use cases

• "List contacts" to get the first page of contacts for a sales call list
• Fetch 25 contacts with --limit 25 to prepare a batch email campaign
• Use the after cursor to paginate through contacts for data export or cleanup
• Verify a contact’s phone and company quickly before a meeting