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
Not seeing a platform that you're looking for? Submit a request for it here.
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":