Tickets
The Ticket object is used to represent a ticket or a task within a system.
Properties

idString
Required

remote_idString
Optional
The third-party API ID of the matching object.

nameString
Optional
The ticket's name.

assigneesArray
Required

creatorString
Optional
The user who created this ticket.

due_dateString
Optional
The ticket's due date.

statusEnum
Optional
The current status of the ticket. Possible values include: OPEN, CLOSED, IN_PROGRESS, ON_HOLD. In cases where there is no clear mapping, the original value passed through will be returned.

descriptionString
Optional
The ticket’s description. HTML version of description is mapped if supported by the third-party platform.

collectionsArray
Required

ticket_typeString
Optional
The ticket's type.

accountString
Optional
The account associated with the ticket.

contactString
Optional
The contact associated with the ticket.

parent_ticketString
Optional
The ticket's parent ticket.

attachmentsAttachment[]
Required
The Attachment object
The Attachment object is used to represent an attachment for a ticket.
JSON
{
"id": "17a54124-287f-494d-965e-3c5b330c9a68",
"remote_id": "19202938",
"file_name": "Screenshot.png",
"ticket": "0958cbc6-6040-430a-848e-aafacbadf4ae",
"file_url": "http://alturl.com/p749b",
"content_type": "jpeg",
"uploaded_by": "28b54125-287f-494d-965e-3c5b330c9a68",
"remote_created_at": "2022-11-10T00:00:00Z",
"remote_was_deleted": true,
"created_at": "2021-09-15T00:00:00Z",
"modified_at": "2021-10-16T00:00:00Z",
Show advanced fields
}
Properties

idString
Required

remote_idString
Optional
The third-party API ID of the matching object.

file_nameString
Optional
The attachment's name. It is required to include the file extension in the attachment's name.

ticketString
Optional
The ticket associated with the attachment.

file_urlString
Optional
The attachment's url. It is required to include the file extension in the file's URL.

content_typeString
Optional
The attachment's file format.

uploaded_byString
Optional
The user who uploaded the attachment.

remote_created_atString
Optional
When the third party's attachment was created.

remote_was_deletedBoolean
Required

created_atString
Required

modified_atString
Required
This is the datetime that this object was last updated by Merge

field_mappingsObject
Optional

remote_dataRemoteData[]
Optional

tagsArray
Required

remote_created_atString
Optional
When the third party's ticket was created.

remote_updated_atString
Optional
When the third party's ticket was updated.

completed_atString
Optional
When the ticket was completed.

remote_was_deletedBoolean
Required

ticket_urlString
Optional
The 3rd party url of the Ticket.

priorityEnum
Optional
The priority or urgency of the Ticket. Possible values include: URGENT, HIGH, NORMAL, LOW. In cases where there is no clear mapping, the original value passed through will be returned.

created_atString
Required

modified_atString
Required
This is the datetime that this object was last updated by Merge

field_mappingsObject
Optional

remote_dataRemoteData[]
Optional

remote_fieldsRemoteField[]
Required

The Ticket object
JSON
{
"id": "0958cbc6-6040-430a-848e-aafacbadf4ae",
"remote_id": "19202938",
"name": "Please add more integrations",
"assignees": [
"17a54124-287f-494d-965e-3c5b330c9a68"
],
"creator": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"due_date": "2022-10-11T00:00:00Z",
"status": "OPEN",
"description": "Can you please add more integrations? It'll make syncing data much easier!",
"collections": [
"fb8c55b6-1cb8-4b4c-9fb6-17924231619d"
],
"ticket_type": "incident",
"account": "0958cbc6-6040-430a-848e-aafacbadf4ae",
"contact": "65c345ba-6870-4974-87ba-dd31509c367a",
"parent_ticket": "75b33d04-30d2-4f3e-be45-27838bc94342",
"attachments": [
"42747df1-95e7-46e2-93cc-66f1191edca5",
"92f972d0-2526-434b-9409-4c3b468e08f0"
],
"tags": [
"enterprise",
"other-tag"
],
"remote_created_at": "2021-11-10T00:00:00Z",
"remote_updated_at": "2021-12-09T00:00:00Z",
"completed_at": "2021-12-09T00:00:00Z",
"remote_was_deleted": true,
"ticket_url": "https://thirdpartysoftware.com/project/3/issue/1",
"priority": "HIGH",
"created_at": "2021-09-15T00:00:00Z",
"modified_at": "2021-10-16T00:00:00Z",
Show advanced fields
}

GET
/tickets

https://api.merge.dev/api/ticketing/v1/tickets

US
EU

Returns a list of Ticket objects.


Header Parameters

AuthorizationString
Required
Token-based authentication with required prefix "Bearer"

X-Account-TokenString
Required
Token identifying the end user.
Query & Path Parameters

account_idString
Optional
If provided, will only return tickets for this account.

assignee_idsString
Optional
If provided, will only return tickets assigned to the assignee_ids; multiple assignee_ids can be separated by commas.

collection_idsString
Optional
If provided, will only return tickets assigned to the collection_ids; multiple collection_ids can be separated by commas.

completed_afterString
Optional
If provided, will only return tickets completed after this datetime.

completed_beforeString
Optional
If provided, will only return tickets completed before this datetime.

contact_idString
Optional
If provided, will only return tickets for this contact.

created_afterString
Optional
If provided, will only return objects created after this datetime.

created_beforeString
Optional
If provided, will only return objects created before this datetime.

cursorString
Optional
The pagination cursor value.

due_afterString
Optional
If provided, will only return tickets due after this datetime.

due_beforeString
Optional
If provided, will only return tickets due before this datetime.

expandString
Optional
Which relations should be returned in expanded form. Multiple relation names should be comma separated without spaces.

include_deleted_dataBoolean
Optional
Whether to include data that was marked as deleted by third party webhooks.

include_remote_dataBoolean
Optional
Whether to include the original data Merge fetched from the third-party to produce these models.

include_remote_fieldsBoolean
Optional
Whether to include all remote fields, including fields that Merge did not map to common models, in a normalized format.

modified_afterString
Optional
If provided, only objects synced by Merge after this date time will be returned.

modified_beforeString
Optional
If provided, only objects synced by Merge before this date time will be returned.

page_sizeInteger
Optional
Number of results to return per page.

parent_ticket_idString
Optional
If provided, will only return sub tickets of the parent_ticket_id.

priorityString
Optional
If provided, will only return tickets of this priority.

project_idString
Optional
If provided, will only return tickets for this project.

remote_created_afterString
Optional
If provided, will only return tickets created in the third party platform after this datetime.

remote_created_beforeString
Optional
If provided, will only return tickets created in the third party platform before this datetime.

remote_fieldsString
Optional
Deprecated. Use show_enum_origins.

remote_idString
Optional
The API provider's ID for the given object.

remote_updated_afterString
Optional
If provided, will only return tickets updated in the third party platform after this datetime.

remote_updated_beforeString
Optional
If provided, will only return tickets updated in the third party platform before this datetime.

show_enum_originsString
Optional
Which fields should be returned in non-normalized form.

statusString
Optional
If provided, will only return tickets of this status.

tagsString
Optional
If provided, will only return tickets matching the tags; multiple tags can be separated by commas.

ticket_typeString
Optional
If provided, will only return tickets of this type.

Response
JSON
{
"next": "cD0yMDIxLTAxLTA2KzAzJTNBMjQlM0E1My40MzQzMjYlMkIwMCUzQTAw",
"previous": "cj1sZXdwd2VycWVtY29zZnNkc2NzUWxNMEUxTXk0ME16UXpNallsTWtJ",
"results": [
{
"id": "0958cbc6-6040-430a-848e-aafacbadf4ae",
"remote_id": "19202938",
"name": "Please add more integrations",
"assignees": [
"17a54124-287f-494d-965e-3c5b330c9a68"
],
"creator": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"due_date": "2022-10-11T00:00:00Z",
"status": "OPEN",
"description": "Can you please add more integrations? It'll make syncing data much easier!",
"collections": [
"fb8c55b6-1cb8-4b4c-9fb6-17924231619d"
],
"ticket_type": "incident",
"account": "0958cbc6-6040-430a-848e-aafacbadf4ae",
"contact": "65c345ba-6870-4974-87ba-dd31509c367a",
"parent_ticket": "75b33d04-30d2-4f3e-be45-27838bc94342",
"attachments": [
"42747df1-95e7-46e2-93cc-66f1191edca5",
"92f972d0-2526-434b-9409-4c3b468e08f0"
],
"tags": [
"enterprise",
"other-tag"
],
"remote_created_at": "2021-11-10T00:00:00Z",
"remote_updated_at": "2021-12-09T00:00:00Z",
"completed_at": "2021-12-09T00:00:00Z",
"remote_was_deleted": true,
"ticket_url": "https://thirdpartysoftware.com/project/3/issue/1",
"priority": "HIGH",
"created_at": "2021-09-15T00:00:00Z",
"modified_at": "2021-10-16T00:00:00Z",
Show advanced fields
}
]
}
Field support by platform
Aha!
Aha!

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


assigneesArray

attachmentsAttachment[]
idstring
remote_idstring
file_namestring
ticketstring
file_urlstring
content_typestring
uploaded_bystring
remote_created_atstring
remote_was_deletedboolean
created_atstring
modified_atstring
field_mappingsobject
remote_dataarray

collectionsArray

creatorString

descriptionString

due_dateString

nameString

remote_created_atString

remote_dataRemoteData[]
pathstring
datastring

remote_idString

remote_updated_atString

statusEnum

tagsArray

ticket_typeString

ticket_urlString
Asana
Asana

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


assigneesArray

attachmentsAttachment[]
idstring
remote_idstring
file_namestring
ticketstring
file_urlstring
content_typestring
uploaded_bystring
remote_created_atstring
remote_was_deletedboolean
created_atstring
modified_atstring
field_mappingsobject
remote_dataarray

collectionsArray

completed_atString

descriptionString

due_dateString

nameString

parent_ticketString

remote_created_atString

remote_dataRemoteData[]
pathstring
datastring

remote_fieldsRemoteField[]
remote_field_classobject
valueobject

remote_idString

remote_updated_atString

statusEnum

tagsArray

ticket_urlString
Azure DevOps
Azure DevOps

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


assigneesArray

attachmentsAttachment[]
idstring
remote_idstring
file_namestring
ticketstring
file_urlstring
content_typestring
uploaded_bystring
remote_created_atstring
remote_was_deletedboolean
created_atstring
modified_atstring
field_mappingsobject
remote_dataarray

collectionsArray

completed_atString

descriptionString

due_dateString

nameString

parent_ticketString

priorityEnum

remote_created_atString

remote_dataRemoteData[]
pathstring
datastring

remote_idString

remote_updated_atString

statusEnum

tagsArray

ticket_typeString

ticket_urlString
Basecamp
Basecamp

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


assigneesArray

collectionsArray

completed_atString

descriptionString

due_dateString

nameString

remote_created_atString

remote_idString

remote_updated_atString

statusEnum

ticket_urlString
Bitbucket
Bitbucket

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


assigneesArray

attachmentsAttachment[]
idstring
remote_idstring
file_namestring
ticketstring
file_urlstring
content_typestring
uploaded_bystring
remote_created_atstring
remote_was_deletedboolean
created_atstring
modified_atstring
field_mappingsobject
remote_dataarray

collectionsArray

creatorString

descriptionString

nameString

priorityEnum

remote_created_atString

remote_dataRemoteData[]
pathstring
datastring

remote_idString

remote_updated_atString

statusEnum

ticket_typeString

ticket_urlString
ClickUp
ClickUp

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


assigneesArray

collectionsArray

completed_atString

creatorString

descriptionString

due_dateString

nameString

parent_ticketString

priorityEnum

remote_created_atString

remote_dataRemoteData[]
pathstring
datastring

remote_idString

remote_updated_atString

statusEnum

tagsArray

ticket_urlString
Dixa
Dixa

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


assigneesArray

contactString

nameString

remote_created_atString

remote_dataRemoteData[]
pathstring
datastring

remote_idString

statusEnum

ticket_typeString
Freshdesk
Freshdesk

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


accountString

assigneesArray

completed_atString

contactString

descriptionString

due_dateString

nameString

priorityEnum

remote_created_atString

remote_dataRemoteData[]
pathstring
datastring

remote_idString

remote_updated_atString

statusEnum

tagsArray

ticket_typeString

ticket_urlString
Freshservice
Freshservice

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


assigneesArray

completed_atString

contactString

descriptionString

due_dateString

nameString

priorityEnum

remote_created_atString

remote_dataRemoteData[]
pathstring
datastring

remote_idString

remote_updated_atString

statusEnum

ticket_typeString

ticket_urlString
Front
Front

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


assigneesArray

collectionsArray

contactString

nameString

remote_created_atString

remote_dataRemoteData[]
pathstring
datastring

remote_idString

statusEnum

tagsArray

ticket_urlString
GitHub Issues
GitHub Issues

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


assigneesArray

collectionsArray

completed_atString

creatorString

descriptionString

nameString

remote_created_atString

remote_dataRemoteData[]
pathstring
datastring

remote_idString

remote_updated_atString

statusEnum

tagsArray

ticket_typeString

ticket_urlString
GitLab
GitLab

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


assigneesArray

collectionsArray

completed_atString

descriptionString

due_dateString

nameString

priorityEnum

remote_created_atString

remote_dataRemoteData[]
pathstring
datastring

remote_idString

remote_updated_atString

statusEnum

tagsArray

ticket_typeString

ticket_urlString
Gladly
Gladly

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


assigneesArray

collectionsArray

contactString

descriptionString

due_dateString

nameString

remote_created_atString

remote_dataRemoteData[]
pathstring
datastring

remote_idString

remote_updated_atString

statusEnum

ticket_typeString

ticket_urlString
Gorgias
Gorgias

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


assigneesArray

completed_atString

contactString

descriptionString

nameString

priorityEnum

remote_created_atString

remote_dataRemoteData[]
pathstring
datastring

remote_idString

remote_updated_atString

statusEnum

tagsArray

ticket_urlString
Height
Height

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


assigneesArray

collectionsArray

completed_atString

descriptionString

nameString

parent_ticketString

remote_created_atString

remote_dataRemoteData[]
pathstring
datastring

remote_idString

remote_updated_atString

statusEnum

ticket_urlString
Help Scout
Help Scout

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


assigneesArray

attachmentsAttachment[]
idstring
remote_idstring
file_namestring
ticketstring
file_urlstring
content_typestring
uploaded_bystring
remote_created_atstring
remote_was_deletedboolean
created_atstring
modified_atstring
field_mappingsobject
remote_dataarray

collectionsArray

completed_atString

contactString

descriptionString

nameString

remote_created_atString

remote_dataRemoteData[]
pathstring
datastring

remote_idString

remote_updated_atString

statusEnum

tagsArray

ticket_typeString

ticket_urlString
Hive
Hive

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


assigneesArray

collectionsArray

completed_atString

descriptionString

due_dateString

nameString

parent_ticketString

priorityEnum

remote_created_atString

remote_dataRemoteData[]
pathstring
datastring

remote_idString

remote_updated_atString

statusEnum

ticket_urlString
Hubspot Ticketing
Hubspot Ticketing

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


assigneesArray

completed_atString

creatorString

descriptionString

nameString

priorityEnum

remote_created_atString

remote_dataRemoteData[]
pathstring
datastring

remote_idString

remote_updated_atString

statusEnum

tagsArray
Intercom
Intercom

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


assigneesArray

completed_atString

contactString

creatorString

descriptionString

nameString

priorityEnum

remote_created_atString

remote_dataRemoteData[]
pathstring
datastring

remote_idString

remote_updated_atString

statusEnum

tagsArray

ticket_typeString

ticket_urlString
Ironclad
Ironclad

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


assigneesArray

attachmentsAttachment[]
idstring
remote_idstring
file_namestring
ticketstring
file_urlstring
content_typestring
uploaded_bystring
remote_created_atstring
remote_was_deletedboolean
created_atstring
modified_atstring
field_mappingsobject
remote_dataarray

completed_atString

nameString

remote_created_atString

remote_dataRemoteData[]
pathstring
datastring

remote_idString

remote_updated_atString

statusEnum

ticket_urlString
Jira
Jira

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


assigneesArray

collectionsArray

completed_atString

creatorString

descriptionString

due_dateString

nameString

parent_ticketString

priorityEnum

remote_created_atString

remote_dataRemoteData[]
pathstring
datastring

remote_fieldsRemoteField[]
remote_field_classobject
valueobject

remote_idString

remote_updated_atString

statusEnum

tagsArray

ticket_typeString

ticket_urlString
Jira Service Management
Jira Service Management

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


assigneesArray

collectionsArray

completed_atString

contactString

descriptionString

due_dateString

nameString

parent_ticketString

priorityEnum

remote_created_atString

remote_dataRemoteData[]
pathstring
datastring

remote_idString

remote_updated_atString

statusEnum

tagsArray

ticket_typeString

ticket_urlString
Kustomer
Kustomer

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


accountString

assigneesArray

completed_atString

contactString

descriptionString

nameString

priorityEnum

remote_created_atString

remote_dataRemoteData[]
pathstring
datastring

remote_idString

remote_updated_atString

statusEnum

tagsArray
Linear
Linear

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


assigneesArray

attachmentsAttachment[]
idstring
remote_idstring
file_namestring
ticketstring
file_urlstring
content_typestring
uploaded_bystring
remote_created_atstring
remote_was_deletedboolean
created_atstring
modified_atstring
field_mappingsobject
remote_dataarray

collectionsArray

completed_atString

descriptionString

due_dateString

nameString

parent_ticketString

priorityEnum

remote_created_atString

remote_dataRemoteData[]
pathstring
datastring

remote_idString

remote_updated_atString

statusEnum

tagsArray

ticket_urlString
Pivotal Tracker
Pivotal Tracker

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


assigneesArray

collectionsArray

descriptionString

nameString

remote_created_atString

remote_dataRemoteData[]
pathstring
datastring

remote_idString

remote_updated_atString

statusEnum

tagsArray

ticket_typeString

ticket_urlString
Rally
Rally

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


assigneesArray

collectionsArray

creatorString

descriptionString

due_dateString

nameString

parent_ticketString

priorityEnum

remote_created_atString

remote_dataRemoteData[]
pathstring
datastring

remote_idString

remote_updated_atString

statusEnum

tagsArray

ticket_typeString

ticket_urlString
Re:amaze
Re:amaze

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


assigneesArray

contactString

descriptionString

nameString

remote_created_atString

remote_dataRemoteData[]
pathstring
datastring

remote_idString

remote_updated_atString

statusEnum

tagsArray

ticket_urlString
Salesforce Service Cloud
Salesforce Service Cloud

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


accountString

assigneesArray

completed_atString

contactString

creatorString

descriptionString

nameString

parent_ticketString

priorityEnum

remote_created_atString

remote_dataRemoteData[]
pathstring
datastring

remote_idString

remote_updated_atString

statusEnum

ticket_typeString

ticket_urlString
ServiceNow
ServiceNow

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


accountString

assigneesArray

completed_atString

contactString

creatorString

descriptionString

due_dateString

nameString

parent_ticketString

priorityEnum

remote_created_atString

remote_dataRemoteData[]
pathstring
datastring

remote_fieldsRemoteField[]
remote_field_classobject
valueobject

remote_idString

remote_updated_atString

statusEnum

tagsArray

ticket_typeString

ticket_urlString
Shortcut
Shortcut

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


assigneesArray

attachmentsAttachment[]
idstring
remote_idstring
file_namestring
ticketstring
file_urlstring
content_typestring
uploaded_bystring
remote_created_atstring
remote_was_deletedboolean
created_atstring
modified_atstring
field_mappingsobject
remote_dataarray

collectionsArray

completed_atString

descriptionString

due_dateString

nameString

parent_ticketString

remote_created_atString

remote_dataRemoteData[]
pathstring
datastring

remote_idString

remote_updated_atString

statusEnum

tagsArray

ticket_typeString

ticket_urlString
SpotDraft
SpotDraft

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


attachmentsAttachment[]
idstring
remote_idstring
file_namestring
ticketstring
file_urlstring
content_typestring
uploaded_bystring
remote_created_atstring
remote_was_deletedboolean
created_atstring
modified_atstring
field_mappingsobject
remote_dataarray

nameString

remote_created_atString

remote_dataRemoteData[]
pathstring
datastring

remote_idString

statusEnum

ticket_urlString
Teamwork
Teamwork

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


assigneesArray

attachmentsAttachment[]
idstring
remote_idstring
file_namestring
ticketstring
file_urlstring
content_typestring
uploaded_bystring
remote_created_atstring
remote_was_deletedboolean
created_atstring
modified_atstring
field_mappingsobject
remote_dataarray

collectionsArray

completed_atString

creatorString

descriptionString

due_dateString

nameString

parent_ticketString

priorityEnum

remote_created_atString

remote_dataRemoteData[]
pathstring
datastring

remote_idString

remote_updated_atString

statusEnum

tagsArray

ticket_urlString
Trello
Trello

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


assigneesArray

attachmentsAttachment[]
idstring
remote_idstring
file_namestring
ticketstring
file_urlstring
content_typestring
uploaded_bystring
remote_created_atstring
remote_was_deletedboolean
created_atstring
modified_atstring
field_mappingsobject
remote_dataarray

collectionsArray

descriptionString

due_dateString

nameString

remote_dataRemoteData[]
pathstring
datastring

remote_idString

remote_updated_atString

statusEnum

tagsArray

ticket_urlString
Wrike
Wrike

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


accountString

assigneesArray

collectionsArray

completed_atString

descriptionString

due_dateString

nameString

parent_ticketString

priorityEnum

remote_created_atString

remote_dataRemoteData[]
pathstring
datastring

remote_idString

remote_updated_atString

statusEnum

ticket_urlString
Zendesk
Zendesk

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


accountString

assigneesArray

completed_atString

contactString

descriptionString

due_dateString

nameString

priorityEnum

remote_created_atString

remote_dataRemoteData[]
pathstring
datastring

remote_idString

remote_updated_atString

statusEnum

tagsArray

ticket_typeString

ticket_urlString
Zoho BugTracker
Zoho BugTracker

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


assigneesArray

attachmentsAttachment[]
idstring
remote_idstring
file_namestring
ticketstring
file_urlstring
content_typestring
uploaded_bystring
remote_created_atstring
remote_was_deletedboolean
created_atstring
modified_atstring
field_mappingsobject
remote_dataarray

collectionsArray

descriptionString

due_dateString

nameString

priorityEnum

remote_created_atString

remote_dataRemoteData[]
pathstring
datastring

remote_idString

remote_updated_atString

statusEnum

tagsArray

ticket_typeString

ticket_urlString
Zoho Desk
Zoho Desk

Merge supports Passthrough Requests to this platform's API

Supported Response Fields


accountString

assigneesArray

completed_atString

contactString

due_dateString

nameString

priorityEnum

remote_created_atString

remote_dataRemoteData[]
pathstring
datastring

remote_idString

remote_updated_atString

statusEnum

tagsArray

ticket_typeString

ticket_urlString
Targetprocess
Targetprocess
Coming soon
Workfront
Workfront
Coming soon
Hint: Use the /linked-accounts endpoint to pull platform support information.
POST
/tickets

https://api.merge.dev/api/ticketing/v1/tickets

US
EU

Creates a Ticket object with the given values.


Header Parameters

AuthorizationString
Required
Token-based authentication with required prefix "Bearer"

X-Account-TokenString
Required
Token identifying the end user.
Query & Path Parameters

is_debug_modeBoolean
Optional
Whether to include debug fields (such as log file links) in the response.

run_asyncBoolean
Optional
Whether or not third-party updates should be run asynchronously.
Body Parameters

modelObject
Required
Find available fields below under “Model Parameters”.
Model Parameters
View app-specific writable fields under “Field support by platform” in this section.

nameString
The ticket's name.

assigneesArray

creatorString
The user who created this ticket. Must pass in a valid Merge ID, which can be obtained from the id field in the User object.

due_dateString
The ticket's due date.

statusEnum
The current status of the ticket. Must pass in one of the following choices: OPEN, CLOSED, IN_PROGRESS, ON_HOLD.

descriptionString
The ticket’s description. HTML version of description is mapped if supported by the third-party platform.

collectionsArray

ticket_typeString
The ticket's type.

accountString
The account associated with the ticket. Must pass in a valid Merge ID, which can be obtained from the id field in the Account object.

contactString
The contact associated with the ticket. Must pass in a valid Merge ID, which can be obtained from the id field in the Contact object.

parent_ticketString
The ticket's parent ticket. Must pass in a valid Merge ID, which can be obtained from the id field in the Ticket object.

attachmentsArray

tagsArray

completed_atString
When the ticket was completed.

ticket_urlString
The 3rd party url of the Ticket.

priorityEnum
The priority or urgency of the Ticket. Must pass in one of the following choices: URGENT, HIGH, NORMAL, LOW.

integration_paramsObject

linked_account_paramsObject

remote_fieldsArray

POST v1/tickets
JSON
{
"model": {
"name": "Please add more integrations",
"assignees": [
"17a54124-287f-494d-965e-3c5b330c9a68"
],
"creator": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"due_date": "2022-10-11T00:00:00Z",
"status": "OPEN",
"description": "Can you please add more integrations? It'll make syncing data much easier!",
"collections": [
"fb8c55b6-1cb8-4b4c-9fb6-17924231619d"
],
"ticket_type": "incident",
"account": "0958cbc6-6040-430a-848e-aafacbadf4ae",
"contact": "65c345ba-6870-4974-87ba-dd31509c367a",
"parent_ticket": "75b33d04-30d2-4f3e-be45-27838bc94342",
"attachments": [
"42747df1-95e7-46e2-93cc-66f1191edca5",
"92f972d0-2526-434b-9409-4c3b468e08f0"
],
"tags": [
"enterprise",
"other-tag"
],
"completed_at": "2021-12-09T00:00:00Z",
"ticket_url": "https://thirdpartysoftware.com/project/3/issue/1",
"priority": "HIGH"
}
}
Response
JSON
{
"model": {
"id": "0958cbc6-6040-430a-848e-aafacbadf4ae",
"remote_id": "19202938",
"name": "Please add more integrations",
"assignees":