hubspot-create-contact_skill

Overview

This skill creates a new contact record in HubSpot CRM from a simple command. It requires an email and accepts optional firstname, lastname, phone, and company fields. The skill validates configuration before running and returns the created contact ID and properties on success.

How this skill works

The skill runs a pre-flight configuration check to ensure HubSpot credentials and scopes are valid. It then calls the HubSpot Contacts API to create a contact with the provided fields and returns a JSON object containing the contact ID and properties. Errors such as authentication failures, missing scopes, duplicates, or rate limits are surfaced with clear codes and remedies.

When to use it

• Add a new lead or customer to HubSpot from a quick workflow
• Capture a contact from a chat, form, or intake process programmatically
• Create a minimal contact when only an email is available
• Include richer contact details when firstname, lastname, phone, or company are known
• Use as part of an automated onboarding sequence to populate CRM

Best practices

• Always run the pre-flight config check to confirm credentials and required scopes before creating contacts
• Provide firstname and lastname when possible to improve matching and segmentation
• Check for existing contacts by email first to avoid 409 duplicate errors
• Handle API rate limits (429) by implementing exponential backoff and retries
• Ensure the integration has crm.objects.contacts.write scope to prevent 403 errors

Example use cases

• Create a contact with only an email during a lightweight signup flow
• Create a full contact record after collecting name, phone, and company on a form
• Use within a bot to add leads captured in conversation to HubSpot CRM
• Run as a step in an onboarding script to seed new customer contacts into CRM
• Batch-create contacts by iterating over parsed input and invoking the skill per contact