skills.rest
FahadImdad
FahadImdadCOMMUNITY
Explore all skills by this author →
GitHub

hubspot-log-email

Logs email engagements in HubSpot CRM via API with subject, body, and direction parameters.

Updated Jan 22, 2026
Search Tags:#api#sales#engagement#crm#hubspot#email logging#log email
One-click install
npx skills add https://github.com/FahadImdad/Nexus-Fahad --skill hubspot-log-email-fahadimdad
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hubspot-log-email
Source: https://github.com/FahadImdad/Nexus-Fahad/tree/main/00-system/skills/hubspot/hubspot-log-email
Command: npx skills add https://github.com/FahadImdad/Nexus-Fahad --skill hubspot-log-email-fahadimdad

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manually recording email conversations in a CRM is repetitive and error-prone. This Skill logs email engagements directly into HubSpot CRM through its API, keeping your contact communication history accurate without switching tools. ## Core Features & Use Cases - Email Engagement Logging: Create email records in HubSpot with subject, body, direction (sent or received), and timestamp. - Pre-Flight Config Check: Validates HubSpot credentials before running, preventing failed API calls. - Structured JSON Output: Returns the created engagement ID and properties for downstream use. - Use Case: After sending a follow-up email to a prospect, log it in HubSpot with one command so the activity appears on the contact timeline for your sales team. ## Quick Start Log an email in HubSpot with the subject "Follow up on proposal" and the body of the message I just sent to the client.

Frequently Asked Questions about hubspot-log-email

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I log an email in HubSpot CRM?▼

Run the log_email.py script with --subject and --body parameters to create an email engagement in HubSpot. Optionally set --direction to EMAIL for sent messages or INCOMING_EMAIL for received ones, and --timestamp for a custom date.

How to record received emails in HubSpot via API?▼

Pass --direction "INCOMING_EMAIL" to the log_email.py script along with the subject and body. HubSpot stores it as an incoming email engagement with the appropriate direction property.

What HubSpot API scope is needed to log emails?▼

Logging emails requires the crm.objects.emails.write scope on your HubSpot access token. A 403 error indicates this scope is missing, while a 401 error means the token itself is invalid and setup must be re-run.

Why does HubSpot email logging return a 429 error?▼

A 429 error means the HubSpot API rate limit has been exceeded. Wait for the rate limit window to reset and retry the request; reducing call frequency prevents recurrence.

Can I link a logged HubSpot email to a contact?▼

The log email script creates the engagement record itself. Use the related hubspot-get-associations skill to associate the logged email with a specific contact record afterward.

Related Skills

Explore More Marketing & Sales Skills→
abdullahbeamabdullahbeam
2

hubspot-connect

Automate HubSpot CRM contact, company, deal, and engagement management operations.

Community
Advanced
wyre-technologywyre-technology
39

HubSpot Activities

Create tasks, log notes, and associate HubSpot CRM objects.

Official
Intermediate
1479089714790897
7

kwp-small-business-crm-maintenance

Synchronize email threads and calendar events with HubSpot CRM records.

Community
Advanced
googleworkspacegoogleworkspace
30.3k

gws-gmail-forward

Forward a Gmail message by ID to specified to, cc, and bcc recipients.

Official
Basic