HubSpot Events Send Event Completions

Name: Events Send Event Completions API
Brand: Events Send Event Completions
Availability: InStock

✓ Official Vendor SpecAnalyticsProduct Analyticsoauth22 Endpoints

Install Jentic One Beta

Connect the Events Send Event Completions to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Events Send Event Completions, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Events Send Event Completions API.

Send a single custom event occurrence against a contact identified by utk, email, or objectId

Send up to 100 event occurrences in one batch call to reduce request overhead

Attach typed property values to each occurrence to enrich downstream reporting

GET STARTED

Start building with Events Send Event Completions API

Explore with Jentic

View OpenAPI Document

For Agents

Send custom behavioural event occurrences (one or in batches up to 100) against HubSpot contacts so they appear in CRM timelines and trigger workflows.

Use for: I need to send a checkout_completed event for contact contact@example.com, Record a batch of 50 onboarding_step_finished events at once, Emit a custom event with order_value and currency properties attached, Backfill historical event occurrences using a custom occurredAt timestamp

Not supported: Does not query event history, define event schemas, or manage contacts - use for sending custom event occurrences only.

Use Cases

Patterns agents use Events Send Event Completions API for, with concrete tasks.

★ Real-Time Product Event Reporting

Forward product behaviour from your application to HubSpot in real time so the same events that exist in your product analytics also appear on the contact's CRM timeline. POST /events/v3/send delivers a single occurrence with its property bag and contact identifier; HubSpot then surfaces it in the contact record and exposes it to reporting and segmentation. Useful for closing the gap between product engagement and lifecycle marketing.

Call POST /events/v3/send with eventName=pe12345_checkout_completed, email=user@example.com, and properties {order_value: 49.99, currency: "USD"}.

Batch Backfill of Historical Events

When migrating from another analytics tool or replaying logs, send historical occurrences in batches of up to 100 with explicit occurredAt timestamps so the events land on the correct day in HubSpot. The batch endpoint returns per-event status so failed items can be retried without resending the whole batch. Useful for one-off migrations and nightly reconciliation jobs.

Call POST /events/v3/send/batch with an inputs array of up to 100 event objects, each with eventName, email, occurredAt, and properties, then read the results array for per-item status.

Workflow Triggering from External Systems

HubSpot workflows can enrol contacts based on a custom event firing. Send the enrolment event from an external system using POST /events/v3/send to trigger a nurture sequence, internal notification, or lifecycle stage update without writing the workflow logic in your own service. Useful for connecting webhooks and serverless functions to HubSpot automation.

Call POST /events/v3/send with the eventName that the target workflow listens for and the matching contact email.

AI Agent Event Emission via Jentic

An AI agent reacting to a Stripe webhook (for example a successful payment) emits a corresponding HubSpot event so the marketing team's nurture flows can react. The agent searches Jentic for HubSpot event-send operations, loads the schema, and executes the call with the contact email, event name, and property bag pulled from the webhook payload. Jentic isolates the OAuth credential so the agent never handles tokens directly.

Search Jentic for "send hubspot custom event", load the schema for POST /events/v3/send, and execute with eventName, email, and properties from the inbound webhook.

Key Endpoints

2 endpoints — the hubspot send event completions api records occurrences of custom behavioural events against contacts in a hubspot account.

METHOD

PATH

DESCRIPTION

POST

/events/v3/send

Send a single custom event occurrence

POST

/events/v3/send/batch

Send up to 100 event occurrences in one batch

POST

/events/v3/send

Send a single custom event occurrence

POST

/events/v3/send/batch

Send up to 100 event occurrences in one batch

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Your HubSpot access token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'send a HubSpot custom event', and Jentic returns the matching operation with its input schema so the agent posts to the right endpoint with the correct payload shape without browsing the reference docs.

Time to first call

FAQs

Specific to using Events Send Event Completions API through Jentic.

What authentication does the Send Event Completions API use?

It accepts HubSpot OAuth 2.0 access tokens or private app tokens, sent as Bearer in the Authorization header. Through Jentic, the token is stored encrypted in your Jentic One instance and never enters the agent's context.

Can I send events in batches?

Yes. POST /events/v3/send/batch accepts up to 100 event objects per call and returns a results array with per-event status so failed items can be retried individually.

How do I identify the contact an event belongs to?

Each event payload accepts one of three identifiers: email, utk (HubSpot user token cookie), or objectId (the CRM contact id). Provide whichever you have; HubSpot will resolve the contact record from it.

What are the rate limits for sending events?

Account-level limits are 100 requests per 10 seconds across HubSpot's authenticated APIs, with daily caps that depend on the subscription tier. Use the batch endpoint to fit more occurrences inside the per-second window.

How do I send a HubSpot event through Jentic?

Run pip install jentic, search for "send hubspot custom event", load the schema for POST /events/v3/send, and execute with eventName, email, occurredAt, and properties. Run Jentic One, the self-hosted execution layer, to get an ak_* key.

Does the eventName have to match an existing event definition?

Yes. The eventName must correspond to a custom event definition created via the Manage Event Definitions API, otherwise HubSpot rejects the occurrence. Internal event names typically take the form pe{portalId}_{eventName}.

Can I limit what my agent is allowed to do with the HubSpot Send Event Completions API?

Yes. Because you run Jentic One yourself, your own rules decide which operations and credentials the agent can use, so you can allow only the single-occurrence POST /events/v3/send call and withhold the batch POST /events/v3/send/batch endpoint unless you explicitly add it. Since the event name and property values travel in the request body, scoping the agent to just the send operation it needs keeps it from emitting occurrences or running batches you did not intend. The encrypted HubSpot token is injected at execution time and never enters the agent's context.

HubSpot Events Send Event Completions

Connect the Events Send Event Completions to your agent

Capabilities

Start building with Events Send Event Completions API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs