For the complete documentation index, see llms.txt. This page is also available as Markdown.

Update Ticket Properties

Updates the standard properties of a HubSpot ticket: pipeline stage (status), priority, type, owner, subject and pipeline. Leave fields empty if you do not want to update them.

Action identifier: update_ticket_properties. Reference checked: 29 September 2026.

Inputs

Field
Type
Required/default
Meaning

ticket_id

string

Required

The ID of the ticket to update

ticket_status

string | null

null

The pipeline stage (status) of the ticket

ticket_priority

string | null

null

The priority of the ticket

ticket_type

string | null

null

The type (category) of the ticket

ticket_owner

string | null

null

The agent the ticket is assigned to

ticket_subject

string | null

null

The subject of the ticket

ticket_pipeline

string | null

null

Pipeline ID from your connected portal.

Output shape

Paths are relative to this action's output. Select them from the builder's variable picker; do not add a ticket wrapper to actions that return top-level fields. Nullable property fields and empty defaults are not proof that a value was retrieved.

Path
Type
Meaning

ticket

object

Returned ticket data; may be a default object when no data is returned.

ticket.id

string

HubSpot record ID.

ticket.properties

object

Property values returned for this record; some declared fields may be empty.

ticket.properties.subject

string | null

The subject of the ticket

ticket.properties.content

string | null

The main content/description of the ticket

ticket.properties.hs_pipeline

string | null

The pipeline ID

ticket.properties.hs_pipeline_stage

string | null

The pipeline stage ID

ticket.properties.hs_ticket_priority

string | null

The priority of the ticket

ticket.properties.hs_ticket_category

string | null

The category of the ticket

ticket.createdAt

string

Creation timestamp returned by HubSpot; empty when unavailable.

ticket.updatedAt

string

Last-update timestamp returned by HubSpot; empty when unavailable.

ticket.archived

boolean

Archive flag returned by HubSpot; defaults to false when omitted.

ticket.full_conversation_content

string

Empty in this action; the update does not fetch conversation content.

success

boolean

True when HubSpot returns updated ticket data; false when no ticket data is returned.

exists

boolean

True when ticket data is returned by the update; false when no ticket data is returned.

Property objects can contain additional fields returned by HubSpot. The declared fields above are not a promise that every property is populated.

Behavior and limits

Provide at least one non-empty field besides ticket_id. Empty values are omitted, so this action cannot clear a field by passing an empty string. Use Update Custom Ticket Fields for a supported explicit clear.

Input mapping: ticket_status → hs_pipeline_stage; ticket_priority → hs_ticket_priority; ticket_type → hs_ticket_category; ticket_owner → hubspot_owner_id; ticket_subject → subject; ticket_pipeline → hs_pipeline.

Status, priority, type and owner choices come from the connected portal. The status list combines pipelines without returning pipeline identity alongside each option; verify the stage belongs to the intended pipeline. Priority falls back to LOW/MEDIUM/HIGH if options are unavailable; type has no fallback.

Follow Find the correct pipeline and status IDs before selecting or changing a pipeline or status.

The owner picker submits the owner record's id and omits owners without a linked userId. It does not submit A-{userId}, the Conversations sender format. Do not convert one identifier into the other by stripping a prefix.

A missing ticket returns false flags. A successful API response returns true flags; verify the resulting properties when the business outcome matters. The returned ticket.full_conversation_content is empty because this action does not fetch a transcript.

See Troubleshooting for request errors and retry behavior, or return to the action catalog.

Was this helpful?