Create Tickets ​
Endpoint ​
POST /unified/ticketing/tickets
Integrations supported
- Asana
- Bitbucket
- Freshdesk
- Gorgias
- Help Scout
- Jira
- Salesforce
- Trello
- Zendesk
Query parameters ​
Refer Specifying query parameters in Truto APIs
The ID of the integrated account to use for the request.
62f44730-dd91-461e-bd6a-aedd9e0ad79d
The format of the response.
unified
will return the response with unified mappings applied.raw
will return the raw response from the remote API.normalized
will apply the unified mappings and return the data in a normalized format.
Defaults to unified
.
unified
raw
normalized
unified
Excludes the remote_data
attribute from the response.
Array of fields to exclude from the response.
truto_exclude_fields[]=id&truto_exclude_fields[]=name
Query parameters to pass to the underlying API without any transformations. Refer this guide to see how to structure the query parameters.
remote_query[foo]=bar
Request Body ​
Refer Writing data using Unified APIsThe name of the ticket
Required in
- Bitbucket
- Gorgias
- Help Scout
- Jira
- Trello
Supported in
- Asana
- Freshdesk
- Salesforce
- Zendesk
Collections associated with the ticket. One of parent_ticket, workspace or collections should be specified.
Required in
- Asana
- Bitbucket
- Help Scout
- Jira
- Trello
The unique identifier for a collection
The name of the collection
The status of the ticket
open
closed
pending
completed
approved
rejected
changes_requested
Enum support by integration
- Gorgias
open
closed
- Asana
pending
completed
approved
rejected
changes_requested
Required in
- Help Scout
Supported in
- Asana
- Bitbucket
- Freshdesk
- Gorgias
- Zendesk
The unique identifier for a status
The name of the status
active
closed
open
pending
spam
resolved
archived
deleted
completed
Contact associated with the ticket
Required in
- Freshdesk
- Help Scout
Supported in
- Gorgias
- Salesforce
- Zendesk
The unique identifier for a contact
The first name of the contact
The last name of the contact
The name of the contact
The emails of the contact
The email of the contact
The type of the email
The comment to add to the ticket. The comment body has a limit of 4000 bytes.
Required in
- Freshdesk
- Gorgias
- Help Scout
- Zendesk
Supported in
- Salesforce
The id of the user or contact who created the comment
The id of the user or contact who created the comment
Type of the author
user
contact
user
contact
user
contact
user
contact
user
contact
The emails of the author
The email of the author
The type of the email
The body of the comment
The body of the comment in HTML format
Users assigned to the ticket
Supported in
- Asana
- Bitbucket
- Gorgias
- Help Scout
- Jira
- Trello
- Zendesk
The unique identifier for a user
The name of the user
The first name of the user
The last name of the user
The user's email addresses
The user's email address
The type of email address
Time at which the ticket was created
Supported in
- Gorgias
- Help Scout
Tags associated with the ticket
Supported in
- Asana
- Freshdesk
- Gorgias
- Help Scout
- Jira
- Trello
- Zendesk
The unique identifier for a tag
The name of the tag
Time at which the ticket was completed
Supported in
- Gorgias
- Help Scout
Time at which the ticket was last updated
Supported in
- Gorgias
An optional ticket number maintained by the system.
Supported in
- Gorgias
- Zendesk
Languages of the ticket
Supported in
- Gorgias
Priority of the ticket
Supported in
- Bitbucket
- Freshdesk
- Jira
- Zendesk
The unique identifier for a priority
The name of the priority
Due date of the ticket
Supported in
- Asana
- Freshdesk
- Jira
- Trello
- Zendesk
Type of the ticket
default_task
milestone
section
approval
Enum support by integration
- Asana
default_task
milestone
section
approval
Required in
- Jira
Supported in
- Asana
- Bitbucket
- Freshdesk
- Zendesk
The unique identifier for a ticket type
The name of the ticket type
Parent ticket associated with the ticket. One of parent_ticket, workspace or collections should be specified.
Required in
- Asana
Supported in
- Jira
The unique identifier for a ticket
The name of the ticket
Description of the ticket
Supported in
- Asana
- Bitbucket
- Jira
- Salesforce
- Trello
Custom fields to set on the ticket
Supported in
- Jira
The HTML description of the task
Supported in
- Asana
The unique identifier for the workspace. One of parent_ticket, workspace or collections should be specified.
Required in
- Asana
- Bitbucket
The unique identifier for a workspace
The name of the workspace
Supported in
- Salesforce
The unique identifier for a source
The name of the source
Any additional data that should be passed as part of the request body. This data is not transformed by Truto and is passed as is to the remote API.
Response Body ​
The unique identifier for a ticket
Supported in
- Asana
- Bitbucket
- Gorgias
- Jira
- Trello
- Zendesk
The name of the ticket
Supported in
- Asana
- Bitbucket
- Gorgias
- Jira
- Trello
- Zendesk
An optional ticket number maintained by the system.
Supported in
- Gorgias
Users assigned to the ticket
Supported in
- Asana
- Bitbucket
- Gorgias
- Jira
- Trello
- Zendesk
The unique identifier for a user
The name of the user
The first name of the user
The last name of the user
The user's email addresses
The user's email address
The type of email address
The status of the ticket
Supported in
- Bitbucket
- Gorgias
- Jira
- Trello
- Zendesk
The unique identifier for a status
The name of the status
active
closed
open
pending
spam
resolved
archived
deleted
completed
User or contact who created the ticket
Supported in
- Bitbucket
- Gorgias
- Jira
- Zendesk
The unique identifier for a user
The name of the user
The type of the user
user
contact
Due date of the ticket
Supported in
- Asana
- Jira
- Trello
- Zendesk
Description of the ticket
Supported in
- Asana
- Bitbucket
- Gorgias
- Jira
- Trello
- Zendesk
Workspace associated with the ticket
Supported in
- Bitbucket
- Trello
The unique identifier for a workspace
The name of the workspace
Team associated with the ticket
The unique identifier for a team
The name of the team
Collections associated with the ticket
Supported in
- Asana
- Bitbucket
- Jira
- Trello
The unique identifier for a collection
The name of the collection
Type of the ticket
Supported in
- Asana
- Bitbucket
- Jira
- Zendesk
The unique identifier for a ticket type
The name of the ticket type
Contact associated with the ticket
Supported in
- Gorgias
- Zendesk
The unique identifier for a contact
The first name of the contact
The last name of the contact
The name of the contact
The emails of the contact
The email of the contact
The type of the email
Parent ticket associated with the ticket
Supported in
- Asana
- Jira
The unique identifier for a ticket
The name of the ticket
Attachments associated with the ticket
Supported in
- Asana
- Jira
The unique identifier for an attachment
The name of the attachment
The url of the attachment
Tags associated with the ticket
Supported in
- Asana
- Gorgias
- Jira
- Trello
- Zendesk
The unique identifier for a tag
The name of the tag
Time at which the ticket was created
Supported in
- Asana
- Bitbucket
- Gorgias
- Jira
- Trello
- Zendesk
Time at which the ticket was last updated
Supported in
- Asana
- Bitbucket
- Gorgias
- Jira
- Trello
- Zendesk
Time at which the ticket was completed
Supported in
- Asana
- Gorgias
- Jira
URL of the ticket
Supported in
- Asana
- Bitbucket
- Jira
- Trello
- Zendesk
Priority of the ticket
Supported in
- Bitbucket
- Gorgias
- Jira
- Trello
- Zendesk
The unique identifier for a priority
The name of the priority
Languages of the ticket
Supported in
- Gorgias
Whether the ticket is unread
Supported in
- Gorgias
The unique identifier for a source
The name of the source
Raw data returned from the remote API call.