hubspot.crm.ticket
Module hubspot.crm.ticket
API
Definitions
![](https://bcentral-packageicons.azureedge.net/images/ballerinax_hubspot.crm.ticket_2.3.0.png)
ballerinax/hubspot.crm.ticket Ballerina library
Overview
This is a generated connector from HubSpot OpenAPI specification.
This API provides access to collections of CRM objects, which return a map of property names to values. Each object type has its own set of default properties, which can be found by exploring the CRM Object Properties API.
Prerequisites
Before using this connector in your Ballerina application, complete the following:
- Create a HubSpot developer account
- Obtain tokens
- Use this guide to obtain the credentials which are needed to create the <CLIENT_ID> and <CLIENT_SECRET>
Quickstart
To use the HubSpot CRM Tickets connector in your Ballerina application, update the .bal file as follows:
Step 1 - Import connector
First, import the ballerinax/hubspot.crm.ticket module into the Ballerina project.
import ballerinax/hubspot.crm.ticket;
Step 2 - Create a new connector instance
You can now make the connection configuration using the access token.
ticket:ClientConfig clientConfig = { auth : { token: <ACCESS_TOKEN> } }; ticket:Client baseClient = check new Client(clientConfig);
Step 3 - Invoke connector operation
- Create a ticket instance
ticket:SimplePublicObjectInput ticket = { properties : { "hs_pipeline": "support_pipeline", "hs_ticket_priority": "HIGH", "hubspot_owner_id": "20436354", "subject": "troubleshoot report" } }; ticket:SimplePublicObject|error bEvent = baseClient->create(ticket); if (bEvent is ticket:SimplePublicObject) { log:printInfo("Created the ticket" + bEvent.toString()); } else { log:printError(msg = bEvent.message()); }
- List tickets
ticket:SimplePublicObjectWithAssociationsArray|error bEvent = baseClient->getPage(); if (bEvent is ticket:SimplePublicObjectWithAssociationsArray) { log:printInfo("Ticket list" + bEvent.toString()); } else { log:printError(msg = bEvent.message()); }
- Use
bal run
command to compile and run the Ballerina program
Clients![](/images/permalink.svg)
hubspot.crm.ticket: Client![](/images/permalink.svg)
This is a generated connector from HubSpot OpenAPI specification. This API provides access to collections of CRM objects, which return a map of property names to values. Each object type has its own set of default properties, which can be found by exploring the CRM Object Properties API.
Constructor![](/images/permalink.svg)
Gets invoked to initialize the connector
.
The connector initialization requires setting the API credentials.
Create a HubSpot account and obtain OAuth tokens following this guide.
init (ConnectionConfig config, string serviceUrl)
- config ConnectionConfig - The configurations to be used when initializing the
connector
- serviceUrl string "https://api.hubapi.com" - URL of the target service
getPage![](/images/permalink.svg)
function getPage(int 'limit, string? after, string[]? properties, string[]? associations, boolean archived) returns SimplePublicObjectWithAssociationsArray|error
List
Parameters
- 'limit int (default 10) - The maximum number of results to display per page.
- after string? (default ()) - The paging cursor token of the last successfully read resource will be returned as the
paging.next.after
JSON property of a paged response containing more results.
- properties string[]? (default ()) - A comma separated list of the properties to be returned in the response. If any of the specified properties are not present on the requested object(s), they will be ignored.
- associations string[]? (default ()) - A comma separated list of object types to retrieve associated IDs for. If any of the specified associations do not exist, they will be ignored.
- archived boolean (default false) - Whether to return only results that have been archived.
Return Type
- SimplePublicObjectWithAssociationsArray|error - successful operation
create![](/images/permalink.svg)
function create(SimplePublicObjectInput payload) returns SimplePublicObject|error
Create
Parameters
- payload SimplePublicObjectInput - Ticket data
Return Type
- SimplePublicObject|error - successful operation
batchArchive![](/images/permalink.svg)
function batchArchive(SimplePublicObjectIdArray payload) returns Response|error
Archive a batch of tickets by ID
Parameters
- payload SimplePublicObjectIdArray - Record containing an array of ticket IDs
batchCreate![](/images/permalink.svg)
function batchCreate(SimplePublicObjectInputArray payload) returns SimplePublicObjectBatchWithErrors|SimplePublicObjectBatch|error
Create a batch of tickets
Parameters
- payload SimplePublicObjectInputArray - Record with an array of ticket data
Return Type
- SimplePublicObjectBatchWithErrors|SimplePublicObjectBatch|error - successful operation
batchRead![](/images/permalink.svg)
function batchRead(SimplePublicObjectIdReadArray payload, boolean archived) returns SimplePublicObjectBatchWithErrors|SimplePublicObjectBatch|error
Read a batch of tickets by internal ID, or unique property values
Parameters
- payload SimplePublicObjectIdReadArray - Object which contains array of internal IDs of tickets
- archived boolean (default false) - Whether to return only results that have been archived.
Return Type
- SimplePublicObjectBatchWithErrors|SimplePublicObjectBatch|error - successful operation
batchUpdate![](/images/permalink.svg)
function batchUpdate(SimplePublicObjectArray payload) returns SimplePublicObjectBatchWithErrors|SimplePublicObjectBatch|error
Update a batch of tickets
Parameters
- payload SimplePublicObjectArray - Record with array of updated ticket data
Return Type
- SimplePublicObjectBatchWithErrors|SimplePublicObjectBatch|error - successful operation
doSearch![](/images/permalink.svg)
function doSearch(PublicObjectSearchRequest payload) returns SimplePublicObjectWithForwardPaging|error
Filter, Sort, and Search CRM Objects
Parameters
- payload PublicObjectSearchRequest - Ticket search request
Return Type
- SimplePublicObjectWithForwardPaging|error - successful operation
getObjectById![](/images/permalink.svg)
function getObjectById(string ticketId, string[]? properties, string[]? associations, boolean archived, string? idProperty) returns SimplePublicObjectWithAssociations|error
Read
Parameters
- ticketId string - Ticket ID
- properties string[]? (default ()) - A comma separated list of the properties to be returned in the response. If any of the specified properties are not present on the requested object(s), they will be ignored.
- associations string[]? (default ()) - A comma separated list of object types to retrieve associated IDs for. If any of the specified associations do not exist, they will be ignored.
- archived boolean (default false) - Whether to return only results that have been archived.
- idProperty string? (default ()) - The name of a property whose values are unique for this object type
Return Type
- SimplePublicObjectWithAssociations|error - successful operation
archive![](/images/permalink.svg)
Archive
Parameters
- ticketId string - Ticket ID
update![](/images/permalink.svg)
function update(string ticketId, SimplePublicObjectInput payload, string? idProperty) returns SimplePublicObject|error
Update
Parameters
- ticketId string - Ticket ID
- payload SimplePublicObjectInput - Attributes to update in ticket
- idProperty string? (default ()) - The name of a property whose values are unique for this object type
Return Type
- SimplePublicObject|error - successful operation
associationsGetAll![](/images/permalink.svg)
function associationsGetAll(string ticketId, string toObjectType, string? after, int 'limit) returns AssociatedIdArrayWithForwardPaging|error
List associations of a ticket by type
Parameters
- ticketId string - Ticket ID
- toObjectType string - Object type to associate with
- after string? (default ()) - The paging cursor token of the last successfully read resource will be returned as the
paging.next.after
JSON property of a paged response containing more results.
- 'limit int (default 500) - The maximum number of results to display per page.
Return Type
- AssociatedIdArrayWithForwardPaging|error - successful operation
associationsCreate![](/images/permalink.svg)
function associationsCreate(string ticketId, string toObjectType, string toObjectId, string associationType) returns SimplePublicObjectWithAssociations|error
Associate a ticket with another object
Parameters
- ticketId string - Ticket ID
- toObjectType string - Object type to associate with
- toObjectId string - Object ID to associate
- associationType string - Type of the association
Return Type
- SimplePublicObjectWithAssociations|error - successful operation
associationsArchive![](/images/permalink.svg)
function associationsArchive(string ticketId, string toObjectType, string toObjectId, string associationType) returns Response|error
Remove an association between two tickets
Records![](/images/permalink.svg)
hubspot.crm.ticket: AssociatedId![](/images/permalink.svg)
Fields
- id string -
- 'type string -
hubspot.crm.ticket: AssociatedIdArray![](/images/permalink.svg)
Fields
- results AssociatedId[] -
- paging Paging? -
hubspot.crm.ticket: AssociatedIdArrayWithForwardPaging![](/images/permalink.svg)
Fields
- results AssociatedId[] -
- paging ForwardPaging? -
hubspot.crm.ticket: ClientHttp1Settings![](/images/permalink.svg)
Provides settings related to HTTP/1.x protocol.
Fields
- keepAlive KeepAlive(default http:KEEPALIVE_AUTO) - Specifies whether to reuse a connection for multiple requests
- chunking Chunking(default http:CHUNKING_AUTO) - The chunking behaviour of the request
- proxy ProxyConfig? - Proxy server related options
hubspot.crm.ticket: ConnectionConfig![](/images/permalink.svg)
Provides a set of configurations for controlling the behaviours when communicating with a remote HTTP endpoint.
Fields
- auth BearerTokenConfig|OAuth2RefreshTokenGrantConfig - Configurations related to client authentication
- httpVersion HttpVersion(default http:HTTP_2_0) - The HTTP version understood by the client
- http1Settings ClientHttp1Settings? - Configurations related to HTTP/1.x protocol
- http2Settings ClientHttp2Settings? - Configurations related to HTTP/2 protocol
- timeout decimal(default 60) - The maximum time to wait (in seconds) for a response before closing the connection
- forwarded string(default "disable") - The choice of setting
forwarded
/x-forwarded
header
- poolConfig PoolConfiguration? - Configurations associated with request pooling
- cache CacheConfig? - HTTP caching related configurations
- compression Compression(default http:COMPRESSION_AUTO) - Specifies the way of handling compression (
accept-encoding
) header
- circuitBreaker CircuitBreakerConfig? - Configurations associated with the behaviour of the Circuit Breaker
- retryConfig RetryConfig? - Configurations associated with retrying
- responseLimits ResponseLimitConfigs? - Configurations associated with inbound response size limits
- secureSocket ClientSecureSocket? - SSL/TLS-related options
- proxy ProxyConfig? - Proxy server related options
- validation boolean(default true) - Enables the inbound payload validation functionality which provided by the constraint package. Enabled by default
hubspot.crm.ticket: Error![](/images/permalink.svg)
Fields
- message string - A human readable message describing the error along with remediation steps where appropriate
- correlationId string - A unique identifier for the request. Include this value with any error reports or support tickets
- category string - The error category
- subCategory string? - A specific category that contains more specific detail about the error
- errors ErrorDetail[]? - further information about the error
- context record {}? - Context about the error condition
- links record {}? - A map of link names to associated URIs containing documentation about the error or recommended remediation steps
hubspot.crm.ticket: ErrorCategory![](/images/permalink.svg)
Fields
- httpStatus string -
- name string -
hubspot.crm.ticket: ErrorDetail![](/images/permalink.svg)
Fields
- message string - A human readable message describing the error along with remediation steps where appropriate
- 'in string? - The name of the field or parameter in which the error was found.
- code string? - The status code associated with the error detail
- subCategory string? - A specific category that contains more specific detail about the error
- context record {}? - Context about the error condition
hubspot.crm.ticket: Filter![](/images/permalink.svg)
Fields
- value string? -
- propertyName string -
- operator string -
hubspot.crm.ticket: FilterGroup![](/images/permalink.svg)
Fields
- filters Filter[] -
hubspot.crm.ticket: ForwardPaging![](/images/permalink.svg)
Fields
- next NextPage? -
hubspot.crm.ticket: NextPage![](/images/permalink.svg)
Fields
- after string -
- link string? -
hubspot.crm.ticket: OAuth2RefreshTokenGrantConfig![](/images/permalink.svg)
OAuth2 Refresh Token Grant Configs
Fields
- Fields Included from *OAuth2RefreshTokenGrantConfig
- refreshUrl string(default "https://api.hubapi.com/oauth/v1/token") - Refresh URL
hubspot.crm.ticket: Paging![](/images/permalink.svg)
Fields
- next NextPage? -
- prev PreviousPage? -
hubspot.crm.ticket: PreviousPage![](/images/permalink.svg)
Fields
- before string -
- link string? -
hubspot.crm.ticket: ProxyConfig![](/images/permalink.svg)
Proxy server configurations to be used with the HTTP client endpoint.
Fields
- host string(default "") - Host name of the proxy server
- port int(default 0) - Proxy server port
- userName string(default "") - Proxy server username
- password string(default "") - Proxy server password
hubspot.crm.ticket: PublicObjectSearchRequest![](/images/permalink.svg)
Fields
- filterGroups FilterGroup[] -
- sorts string[] -
- query string? -
- properties string[] -
- 'limit int -
- after int -
hubspot.crm.ticket: SimplePublicObject![](/images/permalink.svg)
Fields
- id string -
- properties record {} -
- createdAt string -
- updatedAt string -
- archived boolean? -
- archivedAt string? -
hubspot.crm.ticket: SimplePublicObjectArray![](/images/permalink.svg)
Fields
- inputs SimplePublicObjectBatchInput[] -
hubspot.crm.ticket: SimplePublicObjectBatch![](/images/permalink.svg)
Fields
- status string -
- results SimplePublicObject[] -
- requestedAt string? -
- startedAt string -
- completedAt string -
- links record {}? -
hubspot.crm.ticket: SimplePublicObjectBatchInput![](/images/permalink.svg)
Fields
- properties record {} -
- id string -
hubspot.crm.ticket: SimplePublicObjectBatchWithErrors![](/images/permalink.svg)
Fields
- status string -
- results SimplePublicObject[] -
- numErrors int? -
- errors StandardError[]? -
- requestedAt string? -
- startedAt string -
- completedAt string -
- links record {}? -
hubspot.crm.ticket: SimplePublicObjectId![](/images/permalink.svg)
Fields
- id string -
hubspot.crm.ticket: SimplePublicObjectIdArray![](/images/permalink.svg)
Fields
- inputs SimplePublicObjectId[] -
hubspot.crm.ticket: SimplePublicObjectIdReadArray![](/images/permalink.svg)
Fields
- properties string[] -
- idProperty string? -
- inputs SimplePublicObjectId[] -
hubspot.crm.ticket: SimplePublicObjectInput![](/images/permalink.svg)
Fields
- properties record {} -
hubspot.crm.ticket: SimplePublicObjectInputArray![](/images/permalink.svg)
Fields
- inputs SimplePublicObjectInput[] -
hubspot.crm.ticket: SimplePublicObjectWithAssociations![](/images/permalink.svg)
Fields
- id string -
- properties record {} -
- createdAt string -
- updatedAt string -
- archived boolean? -
- archivedAt string? -
- associations record {}? -
hubspot.crm.ticket: SimplePublicObjectWithAssociationsArray![](/images/permalink.svg)
Fields
- results SimplePublicObjectWithAssociations[] -
- paging ForwardPaging? -
hubspot.crm.ticket: SimplePublicObjectWithForwardPaging![](/images/permalink.svg)
Fields
- total int -
- results SimplePublicObject[] -
- paging ForwardPaging? -
hubspot.crm.ticket: StandardError![](/images/permalink.svg)
Fields
- status string -
- id string? -
- category ErrorCategory -
- subCategory record {}? -
- message string -
- errors ErrorDetail[] -
- context record {} -
- links record {} -
Import
import ballerinax/hubspot.crm.ticket;
Metadata
Released date: over 1 year ago
Version: 2.3.0
License: Apache-2.0
Compatibility
Platform: any
Ballerina version: 2201.4.1
GraalVM compatible: Yes
Pull count
Total: 0
Current verison: 0
Weekly downloads
Keywords
Sales & CRM/Customer Relationship Management
Cost/Freemium
Contributors
Dependencies