Create Tickets ​
Endpoint ​
POST /unified/ticketing/tickets
Integrations supported
- Accelo
- Asana
- Azure DevOps
- Bitbucket
- Enchant
- Freshdesk
- Gorgias
- Help Scout
- Helpshift
- Hive
- Jira
- Monday.com
- Pivotal Tracker
- Planhat
- Quickbase for Project Management
- Salesforce
- Trello
- Wrike
- Zendesk
- Zoho Projects
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
Type of the ticket
conversation
issue
Required in
- Azure DevOps
- Planhat
The unique identifier for a ticket type
The name of the ticket type
Required in
- Azure DevOps
Required in
- Zoho Projects
The unique identifier for a organization.
Workspace associated with the ticket
Required in
- Zoho Projects
The unique identifier for a workspace
The name of the workspace
Collection with type project is required.
Required in
- Pivotal Tracker
- Wrike
Request Body ​
Refer Writing data using Unified APIsSet only custom fields with type text.
Supported in
- Azure DevOps
- Hive
- Jira
- Monday.com
- Planhat
- Quickbase for Project Management
- Wrike
The name of the ticket
Required in
- Accelo
- Azure DevOps
- Bitbucket
- Enchant
- Freshdesk
- Gorgias
- Help Scout
- Hive
- Jira
- Monday.com
- Pivotal Tracker
- Planhat
- Trello
- Wrike
- Zoho Projects
Supported in
- Asana
- Helpshift
- Salesforce
- Zendesk
Collections associated with the ticket. One of parent_ticket, workspace or collections should be specified.
Required in
- Asana
- Bitbucket
- Help Scout
- Jira
- Monday.com
- Trello
Supported in
- Hive
- Zoho Projects
The unique identifier for a collection
The name of the collection
The type of the collection
Status supports only for issue ticket type.
open
closed
pending
completed
approved
rejected
changes_requested
active
resolved
accepted
planned
Enum support by integration
- Gorgias
open
closed
- Asana
pending
completed
approved
rejected
changes_requested
- Pivotal Tracker
open
active
completed
pending
resolved
closed
accepted
planned
Required in
- Freshdesk
- Help Scout
Supported in
- Accelo
- Asana
- Azure DevOps
- Bitbucket
- Gorgias
- Pivotal Tracker
- Planhat
- Wrike
- 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
- Enchant
- Freshdesk
- Gorgias
- Help Scout
Supported in
- Accelo
- 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
- 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
The emails of the author
The email of the author
The type of the email
The first name of the author
The last name of the author
The phones of the author
The phone of the author
The type of the phone
The body of the comment
The body of the comment in HTML format
Users assigned to the ticket
Supported in
- Accelo
- Asana
- Azure DevOps
- Bitbucket
- Enchant
- Gorgias
- Help Scout
- Hive
- Jira
- Pivotal Tracker
- Planhat
- Trello
- Wrike
- Zendesk
- Zoho Projects
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
- Helpshift
- Hive
- Jira
- Pivotal Tracker
- Trello
- Zendesk
- Zoho Projects
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
Required in
- Freshdesk
Supported in
- Accelo
- Azure DevOps
- Bitbucket
- Jira
- Pivotal Tracker
- Zendesk
- Zoho Projects
The unique identifier for a priority
The name of the priority
Due date of the ticket
Supported in
- Accelo
- Asana
- Freshdesk
- Hive
- Jira
- Trello
- Zendesk
Type of the ticket
Required in
- Accelo
- Jira
Supported in
- Asana
- Bitbucket
- Freshdesk
- Pivotal Tracker
- Zendesk
The unique identifier for a ticket type
default_task
milestone
section
approval
The name of the ticket type
default_task
milestone
section
approval
Description of the ticket
Required in
- Azure DevOps
- Freshdesk
- Helpshift
Supported in
- Accelo
- Bitbucket
- Hive
- Jira
- Pivotal Tracker
- Planhat
- Salesforce
- Trello
- Wrike
- Zoho Projects
The source of the ticket
Required in
- Freshdesk
Supported in
- Salesforce
The unique identifier for a source
The name of the source
Parent ticket associated with the ticket. One of parent_ticket, workspace or collections should be specified.
Required in
- Asana
Supported in
- Hive
- Jira
The unique identifier for a ticket
The name of the ticket
The group the new item will belong to
Supported in
- Monday.com
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
Supported in
- Enchant
The unique identifier for a workspace
The name of the workspace
Account associated with the ticket
Supported in
- Accelo
The unique identifier for a contact
User or contact who created the ticket
Supported in
- Helpshift
- Pivotal Tracker
The unique identifier for a user
The name of the user
The type of the user
user
contact
Required in
- Planhat
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
- Accelo
- Asana
- Azure DevOps
- Bitbucket
- Enchant
- Freshdesk
- Gorgias
- Helpshift
- Hive
- Jira
- Monday.com
- Pivotal Tracker
- Planhat
- Quickbase for Project Management
- Trello
- Wrike
- Zendesk
- Zoho Projects
The name of the ticket
Supported in
- Accelo
- Asana
- Azure DevOps
- Bitbucket
- Enchant
- Freshdesk
- Gorgias
- Helpshift
- Hive
- Jira
- Monday.com
- Pivotal Tracker
- Planhat
- Trello
- Wrike
- Zendesk
- Zoho Projects
An optional ticket number maintained by the system.
Supported in
- Accelo
- Enchant
- Gorgias
- Hive
- Zoho Projects
Users assigned to the ticket
Supported in
- Accelo
- Asana
- Azure DevOps
- Bitbucket
- Enchant
- Freshdesk
- Gorgias
- Helpshift
- Hive
- Jira
- Pivotal Tracker
- Planhat
- Trello
- Wrike
- Zendesk
- Zoho Projects
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
- Accelo
- Azure DevOps
- Bitbucket
- Enchant
- Freshdesk
- Gorgias
- Helpshift
- Hive
- Jira
- Monday.com
- Pivotal Tracker
- Planhat
- Trello
- Wrike
- Zendesk
- Zoho Projects
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
- Azure DevOps
- Bitbucket
- Gorgias
- Helpshift
- Hive
- Jira
- Monday.com
- Pivotal Tracker
- Zendesk
- Zoho Projects
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
- Accelo
- Asana
- Freshdesk
- Hive
- Jira
- Pivotal Tracker
- Trello
- Wrike
- Zendesk
- Zoho Projects
Description of the ticket
Supported in
- Accelo
- Asana
- Azure DevOps
- Bitbucket
- Enchant
- Freshdesk
- Gorgias
- Helpshift
- Hive
- Jira
- Pivotal Tracker
- Planhat
- Trello
- Wrike
- Zendesk
- Zoho Projects
Workspace associated with the ticket
Supported in
- Accelo
- Azure DevOps
- Bitbucket
- Enchant
- Hive
- Trello
- Zoho Projects
The unique identifier for a workspace
The name of the workspace
Team associated with the ticket
Supported in
- Enchant
The unique identifier for a team
The name of the team
Collections associated with the ticket
Supported in
- Asana
- Bitbucket
- Hive
- Jira
- Monday.com
- Pivotal Tracker
- Trello
- Wrike
- Zoho Projects
The unique identifier for a collection
The name of the collection
The type of the collection
Conversations associated with the ticket
The unique identifier for a conversation
The name of the conversation
The type of the conversation
Type of the ticket
Supported in
- Accelo
- Asana
- Azure DevOps
- Bitbucket
- Enchant
- Freshdesk
- Jira
- Pivotal Tracker
- Planhat
- Zendesk
- Zoho Projects
The unique identifier for a ticket type
The name of the ticket type
Contact associated with the ticket
Supported in
- Accelo
- Enchant
- Freshdesk
- 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
Additional Contacts associated with the ticket
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
Account associated with the ticket
Supported in
- Accelo
- Planhat
The unique identifier for a contact
Parent ticket associated with the ticket
Supported in
- Asana
- Azure DevOps
- Hive
- Jira
- Monday.com
- Wrike
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
- Enchant
- Freshdesk
- Gorgias
- Helpshift
- Hive
- Jira
- Pivotal Tracker
- Trello
- Zendesk
- Zoho Projects
The unique identifier for a tag
The name of the tag
Time at which the ticket was created
Supported in
- Accelo
- Asana
- Azure DevOps
- Bitbucket
- Enchant
- Freshdesk
- Gorgias
- Helpshift
- Hive
- Jira
- Monday.com
- Pivotal Tracker
- Planhat
- Trello
- Wrike
- Zendesk
- Zoho Projects
Time at which the ticket was last updated
Supported in
- Accelo
- Asana
- Azure DevOps
- Bitbucket
- Enchant
- Freshdesk
- Gorgias
- Helpshift
- Hive
- Jira
- Monday.com
- Pivotal Tracker
- Planhat
- Trello
- Wrike
- Zendesk
- Zoho Projects
Time at which the ticket was completed
Supported in
- Accelo
- Asana
- Azure DevOps
- Gorgias
- Jira
- Wrike
- Zoho Projects
URL of the ticket
Supported in
- Accelo
- Asana
- Azure DevOps
- Bitbucket
- Enchant
- Jira
- Monday.com
- Pivotal Tracker
- Trello
- Wrike
- Zendesk
- Zoho Projects
Priority of the ticket
Supported in
- Accelo
- Azure DevOps
- Bitbucket
- Freshdesk
- Gorgias
- Hive
- Jira
- Pivotal Tracker
- Trello
- Wrike
- Zendesk
- Zoho Projects
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 source of the ticket
Supported in
- Enchant
- Freshdesk
- Helpshift
- Zoho Projects
The unique identifier for a source
The name of the source
All the custom fields present on the ticket
Supported in
- Asana
- Azure DevOps
- Hive
- Planhat
- Quickbase for Project Management
- Wrike
The unique identifier for the specific version of the resource.
Raw data returned from the remote API call.