Create Tickets
/unified/ticketing/tickets
Query Parameters
Refer Specifying query parameters in Truto APIs
Type of the ticket
conversationissue
15 supported2 required
The unique identifier for a ticket type
The name of the ticket type
1 supported1 required
Collection with type project is required.
14 supported2 required
TodoistThe unique identifier for a collection
The name of the collection
The type of the collection
1 supported
The unique identifier for a organization.
Workspace associated with the ticket
9 supported1 required
The unique identifier for a workspace
The name of the workspace
Show Truto-specific parameters
The ID of the integrated account to use for the request.
62f44730-dd91-461e-bd6a-aedd9e0ad79dThe format of the response.
unifiedreturns the response with unified mappings applied.rawreturns the unprocessed, raw response from the remote API.normalizedapplies the unified mappings and returns the data in a normalized format.streamreturns the response as a stream, which is ideal for transmitting large datasets, files, or binary data. Using streaming mode helps to efficiently handle large payloads or real-time data flows without requiring the entire data to be buffered in memory.
Defaults to unified.
unifiedunifiedrawnormalizedstream
Excludes the remote_data attribute from the response.
Array of fields to exclude from the response.
truto_exclude_fields[]=id&truto_exclude_fields[]=nameQuery parameters to pass to the underlying API without any transformations. Refer this guide to see how to structure the query parameters.
remote_query[foo]=barRequest Body
Refer Writing data using Unified APIs
Account associated with the ticket
3 supported
The unique identifier for a contact
1 supported1 required
Additional Contacts associated with the ticket
1 supported
The emails of the contact
2 properties
The email of the contact
The type of the email
The first name of the contact
The unique identifier for a contact
The last name of the contact
The name of the contact
The contact's phone number
2 properties
The contact's phone number
The type of phone number
Users assigned to the ticket
23 supported
TodoistThe unique identifier for a user
The name of the user
The user's email addresses
2 properties
The user's email address
The type of email address
The first name of the user
The last name of the user
The user's phone number
2 properties
The user's phone number
The type of phone number
Collections associated with the ticket. One of parent_ticket, workspace or collections should be specified.
15 supported7 required
TodoistThe unique identifier for a collection
The type of the collection
componentproduct
The name of the collection
The comment to add to the ticket. The comment body has a limit of 4000 bytes.
4 supported3 required
The body of the comment
The body of the comment in HTML format
The body of the comment in Markdown format
The id of the user or contact who created the comment
6 properties
Type of the author
usercontactusercontactusercontactusercontact
The emails of the author
2 properties
The email of the author
The type of the email
The first name of the author
The id of the user or contact who created the comment
The last name of the author
The phones of the author
2 properties
The phone of the author
The type of the phone
Time at which the ticket was completed
10 supported
Contact associated with the ticket
12 supported6 required
The unique identifier for a contact
The emails of the contact
2 properties
The email of the contact
The type of the email
The first name of the contact
The last name of the contact
The name of the contact
The contact's phone number
2 properties
The contact's phone number
The type of phone number
Time at which the ticket was created
25 supported
TodoistUser or contact who created the ticket
16 supported
TodoistThe unique identifier for a user
The name of the user
The type of the user
usercontact
An object containing the custom fields to add to the Monday Item.
11 supported
Description of the ticket
25 supported5 required
TodoistDue date of the ticket
14 supported
TodoistThe group the new item will belong to
1 supported
The HTML description of the task
1 supported
Languages of the ticket
3 supported
TodoistThe name of the ticket
27 supported23 required
TodoistAn optional ticket number maintained by the system.
9 supported
Parent ticket associated with the ticket. One of parent_ticket, workspace or collections should be specified.
9 supported1 required
TodoistThe unique identifier for a ticket
The name of the ticket
Priority of the ticket
17 supported1 required
TodoistThe unique identifier for a priority
The name of the priority
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.
The source of the ticket
5 supported1 required
The unique identifier for a source
The name of the source
Status supports only for issue ticket type.
pendingcompletedapprovedrejectedchanges_requestedopenclosedarchivedactiveopenactivecompletedpendingresolvedclosedacceptedplanned+ 5 more
25 supported4 required
openclosedopenactivecompletedpendingresolvedclosedacceptedplannedTodoistThe unique identifier for a status
The name of the status
activeclosedopenpendingspamresolvedarchiveddeletedcompleted
Tags associated with the ticket
14 supported
TodoistThe name of the tag
The unique identifier for a tag
Team associated with the ticket
5 supported1 required
The unique identifier for a team
The name of the team
Type of the ticket
15 supported4 required
The unique identifier for a ticket type
default_taskmilestonesectionapproval
The name of the ticket type
default_taskmilestonesectionapproval
Time at which the ticket was last updated
23 supported
The unique identifier for the workspace. One of parent_ticket, workspace or collections should be specified.
10 supported4 required
The unique identifier for a workspace
The name of the workspace
Response Body
The unique identifier for a ticket
29 supported
TodoistAccount associated with the ticket
3 supported
The unique identifier for a contact
Additional Contacts associated with the ticket
1 supported
The emails of the contact
2 properties
The email of the contact
The type of the email
The first name of the contact
The unique identifier for a contact
The last name of the contact
The name of the contact
The contact's phone number
2 properties
The contact's phone number
The type of phone number
Users assigned to the ticket
23 supported
TodoistThe user's email addresses
2 properties
The user's email address
The type of email address
The first name of the user
The unique identifier for a user
The last name of the user
The name of the user
The user's phone number
2 properties
The user's phone number
The type of phone number
Attachments associated with the ticket
4 supported
The name of the attachment
The url of the attachment
The unique identifier for an attachment
Collections associated with the ticket
14 supported
TodoistThe unique identifier for a collection
The name of the collection
The type of the collection
Time at which the ticket was completed
10 supported
Contact associated with the ticket
10 supported
The emails of the contact
2 properties
The email of the contact
The type of the email
The first name of the contact
The unique identifier for a contact
The last name of the contact
The name of the contact
The contact's phone number
2 properties
The contact's phone number
The type of phone number
Conversations associated with the ticket
1 supported
The unique identifier for a conversation
The name of the conversation
The type of the conversation
Time at which the ticket was created
25 supported
TodoistUser or contact who created the ticket
16 supported
TodoistThe unique identifier for a user
The name of the user
The type of the user
usercontact
All the custom fields present on the ticket
11 supported
Description of the ticket
24 supported
TodoistDue date of the ticket
14 supported
TodoistThe unique identifier for the specific version of the resource.
Whether the ticket is unread
1 supported
Languages of the ticket
3 supported
TodoistThe name of the ticket
25 supported
TodoistAn optional ticket number maintained by the system.
9 supported
Parent ticket associated with the ticket
9 supported
TodoistThe unique identifier for a ticket
The name of the ticket
Priority of the ticket
17 supported
TodoistThe unique identifier for a priority
The name of the priority
Raw data returned from the remote API call.
The source of the ticket
5 supported
The unique identifier for a source
The name of the source
The status of the ticket
24 supported
TodoistThe unique identifier for a status
The name of the status
activeclosedopenpendingspamresolvedarchiveddeletedcompleted
Tags associated with the ticket
14 supported
TodoistThe unique identifier for a tag
The name of the tag
Team associated with the ticket
4 supported
The unique identifier for a team
The name of the team
Type of the ticket
15 supported
The unique identifier for a ticket type
The name of the ticket type
URL of the ticket
17 supported
TodoistTime at which the ticket was last updated
23 supported
Workspace associated with the ticket
9 supported
The unique identifier for a workspace
The name of the workspace
curl -X POST 'https://api.truto.one/unified/ticketing/tickets?integrated_account_id=<integrated_account_id>' \
-H 'Authorization: Bearer <your_api_token>' \
-H 'Content-Type: application/json' \
-d '{
"name": "your_name",
"contact": {},
"account": {},
"ticket_type": {},
"status": "pending",
"due_date": "your_due_date",
"description": "your_description",
"assignees": [],
"priority": {},
"collections": [],
"html_description": "your_html_description",
"tags": [],
"parent_ticket": {},
"workspace": "your_workspace",
"custom_fields": {},
"team": {},
"source": {},
"completed_at": "your_completed_at",
"created_at": "your_created_at",
"updated_at": "your_updated_at",
"number": "your_number",
"languages": [],
"comment": {},
"created_by": {},
"additional_contacts": [],
"group_id": "your_group_id",
"remote_data": {}
}'const integratedAccountId = '<integrated_account_id>';
const body = {
"name": "your_name",
"contact": {},
"account": {},
"ticket_type": {},
"status": "pending",
"due_date": "your_due_date",
"description": "your_description",
"assignees": [],
"priority": {},
"collections": [],
"html_description": "your_html_description",
"tags": [],
"parent_ticket": {},
"workspace": "your_workspace",
"custom_fields": {},
"team": {},
"source": {},
"completed_at": "your_completed_at",
"created_at": "your_created_at",
"updated_at": "your_updated_at",
"number": "your_number",
"languages": [],
"comment": {},
"created_by": {},
"additional_contacts": [],
"group_id": "your_group_id",
"remote_data": {}
};
const response = await fetch(`https://api.truto.one/unified/ticketing/tickets?integrated_account_id=${integratedAccountId}`, {
method: 'POST',
headers: {
'Authorization': 'Bearer <your_api_token>',
'Content-Type': 'application/json',
},
body: JSON.stringify(body),
});
const data = await response.json();
console.log(data);import requests
url = "https://api.truto.one/unified/ticketing/tickets"
headers = {
"Authorization": "Bearer <your_api_token>",
"Content-Type": "application/json",
}
params = {
"integrated_account_id": "<integrated_account_id>"
}
payload = {
"name": "your_name",
"contact": {},
"account": {},
"ticket_type": {},
"status": "pending",
"due_date": "your_due_date",
"description": "your_description",
"assignees": [],
"priority": {},
"collections": [],
"html_description": "your_html_description",
"tags": [],
"parent_ticket": {},
"workspace": "your_workspace",
"custom_fields": {},
"team": {},
"source": {},
"completed_at": "your_completed_at",
"created_at": "your_created_at",
"updated_at": "your_updated_at",
"number": "your_number",
"languages": [],
"comment": {},
"created_by": {},
"additional_contacts": [],
"group_id": "your_group_id",
"remote_data": {}
}
response = requests.post(url, headers=headers, params=params, json=payload)
print(response.json())import Truto from '@truto/truto-ts-sdk';
const truto = new Truto({
token: '<your_api_token>',
});
const result = await truto.unifiedApi.create(
'ticketing',
'tickets',
{
"name": "your_name",
"contact": {},
"account": {},
"ticket_type": {},
"status": "pending",
"due_date": "your_due_date",
"description": "your_description",
"assignees": [],
"priority": {},
"collections": [],
"html_description": "your_html_description",
"tags": [],
"parent_ticket": {},
"workspace": "your_workspace",
"custom_fields": {},
"team": {},
"source": {},
"completed_at": "your_completed_at",
"created_at": "your_created_at",
"updated_at": "your_updated_at",
"number": "your_number",
"languages": [],
"comment": {},
"created_by": {},
"additional_contacts": [],
"group_id": "your_group_id",
"remote_data": {}
},
{ integrated_account_id: '<integrated_account_id>' }
);
console.log(result);import asyncio
from truto_python_sdk import TrutoApi
truto_api = TrutoApi(token="<your_api_token>")
async def main():
result = await truto_api.unified_api.create(
"ticketing",
"tickets",
{
"name": "your_name",
"contact": {},
"account": {},
"ticket_type": {},
"status": "pending",
"due_date": "your_due_date",
"description": "your_description",
"assignees": [],
"priority": {},
"collections": [],
"html_description": "your_html_description",
"tags": [],
"parent_ticket": {},
"workspace": "your_workspace",
"custom_fields": {},
"team": {},
"source": {},
"completed_at": "your_completed_at",
"created_at": "your_created_at",
"updated_at": "your_updated_at",
"number": "your_number",
"languages": [],
"comment": {},
"created_by": {},
"additional_contacts": [],
"group_id": "your_group_id",
"remote_data": {}
},
{"integrated_account_id": "<integrated_account_id>"}
)
print(result)
asyncio.run(main())