POST /api/v2/imports/tickets/create_many
Accepts an array of up to 100 ticket objects.
Allowed For
- Admins
Servers
- https://{subdomain}.{domain}.com
Request headers
| Name | Type | Required | Description |
|---|---|---|---|
Content-Type |
String | Yes |
The media type of the request body.
Default value: "application/json" |
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
archive_immediately |
Boolean | No |
If |
Request body fields
| Name | Type | Required | Description |
|---|---|---|---|
tickets[] |
Array | No | |
tickets[].requester_id |
Integer | No |
The user who requested this ticket |
tickets[].assignee_id |
Integer | No |
The agent currently assigned to the ticket |
tickets[].description |
String | No |
Read-only first comment on the ticket. When creating a ticket, use |
tickets[].tags[] |
Array | No |
The array of tags applied to this ticket |
tickets[].subject |
String | No |
The value of the subject field for this ticket |
tickets[].comments[] |
Array | No |
The conversation between requesters, collaborators, and agents |
tickets[].comments[].via |
Object | No |
Describes how the object was created. See the Via object reference |
tickets[].comments[].via.source |
Object | No |
For some channels a source object gives more information about how or why the ticket or event was created |
tickets[].comments[].via.channel |
String | No |
This tells you how the ticket or event was created. Examples: "web", "mobile", "rule", "system" |
tickets[].comments[].public |
Boolean | No |
true if a public comment; false if an internal note. The initial value set on ticket creation persists for any additional comment unless you change it |
tickets[].comments[].metadata |
Object | No |
System information (web client, IP address, etc.) and comment flags, if any. See Comment flags |
tickets[].comments[].value |
String | No |
The comment string value |
tickets[].comments[].id |
Integer | No |
Automatically assigned when the comment is created |
tickets[].comments[].plain_body |
String | No |
The comment presented as plain text. See Bodies |
tickets[].comments[].attachments[] |
Array | No |
Attachments, if any. See Attachment |
tickets[].comments[].attachments[].content_type |
String | No |
The content type of the image. Example value: "image/png" |
tickets[].comments[].attachments[].inline |
Boolean | No |
If true, the attachment is excluded from the attachment list and the attachment's URL can be referenced within the comment of a ticket. Default is false |
tickets[].comments[].attachments[].size |
Integer | No |
The size of the image file in bytes |
tickets[].comments[].attachments[].deleted |
Boolean | No |
If true, the attachment has been deleted |
tickets[].comments[].attachments[].height |
String | No |
The height of the image file in pixels. If height is unknown, returns null |
tickets[].comments[].attachments[].url |
String | No |
A URL to access the attachment details |
tickets[].comments[].attachments[].width |
String | No |
The width of the image file in pixels. If width is unknown, returns null |
tickets[].comments[].attachments[].thumbnails[] |
Array | No |
An array of attachment objects. Note that photo thumbnails do not have thumbnails |
tickets[].comments[].attachments[].thumbnails[].content_type |
String | No |
The content type of the image. Example value: "image/png" |
tickets[].comments[].attachments[].thumbnails[].inline |
Boolean | No |
If true, the attachment is excluded from the attachment list and the attachment's URL can be referenced within the comment of a ticket. Default is false |
tickets[].comments[].attachments[].thumbnails[].size |
Integer | No |
The size of the image file in bytes |
tickets[].comments[].attachments[].thumbnails[].deleted |
Boolean | No |
If true, the attachment has been deleted |
tickets[].comments[].attachments[].thumbnails[].height |
String | No |
The height of the image file in pixels. If height is unknown, returns null |
tickets[].comments[].attachments[].thumbnails[].url |
String | No |
A URL to access the attachment details |
tickets[].comments[].attachments[].thumbnails[].width |
String | No |
The width of the image file in pixels. If width is unknown, returns null |
tickets[].comments[].attachments[].thumbnails[].malware_access_override |
Boolean | No |
If true, you can download an attachment flagged as malware. If false, you can't download such an attachment. |
tickets[].comments[].attachments[].thumbnails[].mapped_content_url |
String | No |
The URL the attachment image file has been mapped to |
tickets[].comments[].attachments[].thumbnails[].file_name |
String | No |
The name of the image file |
tickets[].comments[].attachments[].thumbnails[].content_url |
String | No |
A full URL where the attachment image file can be downloaded. The file may be hosted externally so take care not to inadvertently send Zendesk authentication credentials. See Working with url properties |
tickets[].comments[].attachments[].thumbnails[].id |
Integer | No |
Automatically assigned when created |
tickets[].comments[].attachments[].thumbnails[].malware_scan_result |
String | No |
The result of the malware scan. There is a delay between the time the attachment is uploaded and when the malware scan is completed. Usually the scan is done within a few seconds, but high load conditions can delay the scan results. Possible values: "malware_found", "malware_not_found", "failed_to_scan", "not_scanned" |
tickets[].comments[].attachments[].malware_access_override |
Boolean | No |
If true, you can download an attachment flagged as malware. If false, you can't download such an attachment. |
tickets[].comments[].attachments[].mapped_content_url |
String | No |
The URL the attachment image file has been mapped to |
tickets[].comments[].attachments[].file_name |
String | No |
The name of the image file |
tickets[].comments[].attachments[].content_url |
String | No |
A full URL where the attachment image file can be downloaded. The file may be hosted externally so take care not to inadvertently send Zendesk authentication credentials. See Working with url properties |
tickets[].comments[].attachments[].id |
Integer | No |
Automatically assigned when created |
tickets[].comments[].attachments[].malware_scan_result |
String | No |
The result of the malware scan. There is a delay between the time the attachment is uploaded and when the malware scan is completed. Usually the scan is done within a few seconds, but high load conditions can delay the scan results. Possible values: "malware_found", "malware_not_found", "failed_to_scan", "not_scanned" |
tickets[].comments[].author_id |
Integer | No |
The id of the comment author. See Author id |
tickets[].comments[].audit_id |
Integer | No |
The id of the ticket audit record. See Show Audit |
tickets[].comments[].body |
String | No |
The comment string. See Bodies |
tickets[].comments[].type |
String | No |
|
tickets[].comments[].html_body |
String | No |
The comment formatted as HTML. See Bodies |
tickets[].comments[].uploads[] |
Array | No |
List of tokens received from uploading files for comment attachments. The files are attached by creating or updating tickets with the tokens. See Attaching files in Tickets |
tickets[].comments[].created_at |
String | No |
The time the comment was created |
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.