Is there a way to create a ticket from the API? I have summer collection coming soon and need a way to allow my "first check" system to email parents damage reports and to make a workorder/ticket in Incident IQ. Is there an example of creating a ticket via the API?
Solved
Ticket creation via API?
+2Best answer by bnelson_iiQ
curl --location 'https://[SITE].incidentiq.com/api/v1.0/tickets/simple/new' \
--header 'user-agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36' \
--header 'client: WebBrowser' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/plain, */*' \
--header 'Authorization: Bearer [ENTER TOKEN HERE]' \
--header 'accept-language: en-US,en;q=0.9' \
--data '{
"Issue":"[TICKET ISSUE]",
"IssueDescription": "[ENTER DESCRIPTION]"
}'Please note that you will need to replace [SITE] with your corresponding IIQ URL and paste your bearer token into [ENTER TOKEN HERE]. Additionally, you can enter in an issue to automatically add into the ticket description by replacing [TICKET ISSUE] and a ticket description by replacing [ENTER DESCRIPTION].
With that being said, I hope this information helps and if you need anything else we’re here to help!
curl --location 'https://[SITE].incidentiq.com/api/v1.0/tickets/simple/new' \
--header 'user-agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36' \
--header 'client: WebBrowser' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/plain, */*' \
--header 'Authorization: Bearer [ENTER TOKEN HERE]' \
--header 'accept-language: en-US,en;q=0.9' \
--data '{
"Issue":"[TICKET ISSUE]",
"IssueDescription": "[ENTER DESCRIPTION]"
}'Please note that you will need to replace [SITE] with your corresponding IIQ URL and paste your bearer token into [ENTER TOKEN HERE]. Additionally, you can enter in an issue to automatically add into the ticket description by replacing [TICKET ISSUE] and a ticket description by replacing [ENTER DESCRIPTION].
With that being said, I hope this information helps and if you need anything else we’re here to help!
+2We have defined ticket issues - how can I find the issue id easily for this?
We have defined ticket issues - how can I find the issue id easily for this?
The quickest way, IMO, is to look up an existing ticket of that issue using this call:
'https://[SITE].incidentiq.com/api/v1.0/tickets/[TICKETID]’ (the ticket ID is in the URL of the ticket in iiQ)
From there you can find your issue ID in the results.
+18
Thank you
We also just did something very similar. We just developed what we call a Device Inspection App that each school uses mainly at the end of the year but can use anything they are collecting a device from a student. The front end of the app is custom developed and pulls all the data from our local IIQ database but it also uses some API calls to update the status of the device if its reported damaged.
In our app they put both damages and missing accessories in for the device and then we use PowerAutomate which is a Microsoft product if you are a Microsoft shop to send an email to the parents and students and it includes the damages and missing accessories. With PowerAutomate we also insert the fee directly into our SIS system. If damages are selected then we just shoot an email into IIQ which will have a checklist attached to it. Because of the timeframe we had which was two weeks we didn’t have time to create the ticket via the API but I plan on coming back to it and using PowerAutomate to do that also. Let me know if you have any further questions about our process?
+2+2So I’ve looked up what issues I need - but how can I set my IssueID properly?
#45211 - MacBook Air 13" M1 Silver 128 GB (2020) > Issue not listed
TESTING THINGS HERE Issue not found (6c5b716d-6269-e611-80f1-000c29ab80b0).
+2curl --location 'https://[SITE].incidentiq.com/api/v1.0/tickets/simple/new' \
--header 'user-agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36' \
--header 'client: WebBrowser' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/plain, */*' \
--header 'Authorization: Bearer [ENTER TOKEN HERE]' \
--header 'accept-language: en-US,en;q=0.9' \
--data '{
"Issue":"[TICKET ISSUE]",
"IssueDescription": "[ENTER DESCRIPTION]"
}'Please note that you will need to replace [SITE] with your corresponding IIQ URL and paste your bearer token into [ENTER TOKEN HERE]. Additionally, you can enter in an issue to automatically add into the ticket description by replacing [TICKET ISSUE] and a ticket description by replacing [ENTER DESCRIPTION].
With that being said, I hope this information helps and if you need anything else we’re here to help!
The issue - I’m trying to put in the UID for the ticket issue but it says not found - any suggestions on what I should be putting there?
"IssueId": "d6be4473-4bc0-e911-a40a-281878def635"
Use the same as above but instead of using Issue use IssueID and then you can use the GUID. Let me know if that helps.
This will give you the entire Subject Line:
{
"IssueDescription": "Here is the description.",
"OwnerId": "deaf4603-88d3-4ad6-a343-83c162205ca9",
"IssueId": "d6be4473-4bc0-e911-a40a-281878def635",
"Assets": [
{
"AssetId": "b2e23fa0-b426-e911-b8b3-2818784a7157"
}
]
}
In my example above it will automatically create the Subject of the Ticket to Clever - Application Missing - Missing Icon.
AssetID = Clever
IssueID = Application Missing - Missing Icon
Hope that helps.
+18curl --location 'https://[SITE].incidentiq.com/api/v1.0/tickets/simple/new' \
--header 'user-agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36' \
--header 'client: WebBrowser' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/plain, */*' \
--header 'Authorization: Bearer [ENTER TOKEN HERE]' \
--header 'accept-language: en-US,en;q=0.9' \
--data '{
"Issue":"[TICKET ISSUE]",
"IssueDescription": "[ENTER DESCRIPTION]"
}'Please note that you will need to replace [SITE] with your corresponding IIQ URL and paste your bearer token into [ENTER TOKEN HERE]. Additionally, you can enter in an issue to automatically add into the ticket description by replacing [TICKET ISSUE] and a ticket description by replacing [ENTER DESCRIPTION].
With that being said, I hope this information helps and if you need anything else we’re here to help!
The issue - I’m trying to put in the UID for the ticket issue but it says not found - any suggestions on what I should be putting there?
Good morning
curl --location 'https://[SITE].incidentiq.com/api/v1.0/tickets/new' \
--header 'accept: application/json, text/plain, */*' \
--header 'accept-language: en-US,en;q=0.9' \
--header 'client: WebBrowser' \
--header 'content-type: application/json' \
--header 'user-agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/109.0.0.0 Safari/537.36' \
--header 'Authorization: Bearer [ENTER TOKEN HERE]' \
--data '{
"IssueDescription": "Test Ticket Creation Endpoint",
"IssueCategoryId":"[CATEGORY ID]",
"IssueId":"[ISSUE ID]",
"IssueTypeId":"[ISSUE TYPE ID]"
}'If you need to look up Issues for your site and the corresponding ID’s needed you can use the following cURL to pull this data:
curl --location 'https://[SITE].incidentiq.com/api/v1.0/issues?%2524s=99999&filter=SearchText%2520contains%2520%2527account%2527' \
--header 'Accept-Language: en-US,en;q=0.9' \
--header 'Client: WebBrowser' \
--header 'ProductId: 88df910c-91aa-e711-80c2-0004ffa00010' \
--header 'Pragma: no-cache' \
--header 'User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/69.0.3497.100 Safari/537.36' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json, text/plain, */*' \
--header 'Cache-Control: no-cache' \
--header 'Authorization: Bearer [ENTER TOKEN HERE]' \
--header 'SiteId: [FOUND ON THE DEVELOPER'S TOOLS PAGE]' \
--data '{
"ProductId": "[FOUND ON THE DEVELOPER'S TOOLS PAGE]",
"SiteScope": "Aggregate",
"Strategy": "All"
}'This will pull the data for all issues, and will allow you to plug in the corresponding IssueCategoryId, IssueID, and IssueTypeId as needed. With that being said, if you have any additional questions or concerns please let us know!
+2Is there a trick to get the incident id tied to the end user’s asset? The API doesn’t error when I try to create something but it doesn’t tie it back to the asset. Any suggestions?
{
"IssueDescription": "Here is the description.",
"OwnerId": "deaf4603-88d3-4ad6-a343-83c162205ca9",
"IssueId": "d6be4473-4bc0-e911-a40a-281878def635",
"Assets": [
{
"AssetId": "b2e23fa0-b426-e911-b8b3-2818784a7157"
}
]
}
You want to focus on this part of the JSON outlined in red to get the asset attached to the Ticket via API.
In my example I’m hardcoding a few things in as I’m always dealing with the same model and category of Chromebooks.
For you it will look like this:
+2$data = ['Assets' => ['AssetId' => ‘asdfasdf'], 'IssueId' => 'asdfasdfe', 'IssueDescription' => 'Some hardware issue here', 'AssignedToTeamId' => 'asdfasdf', 'ForID' => 'asdfsafde','LocationId'=>'asdf']; $response = Http::withToken(env('INCIDENT_IQ_TOKEN'))->post(env('INCIDENT_IQ_ADDRESS').'/tickets/new',$data);
No error . . . just doesn’t assign to my asset
+2Yes.
I’m using PostMan and the full JSON I have is below and is working with no issues.
{
"Subject": "Employee Device - Windows - Testing",
"IssueDescription": "Testing with Asset attached to the record",
"OwnerId": "deaf4603-88d3-4ad6-a343-83c162205ca9",
"ForId": "deaf4603-88d3-4ad6-a343-83c162205ca9",
"IssueId": "363e2521-bfde-ed11-9f72-6045bd85ef2b",
"TicketFollowerUserIds": [
""
],
"Assets": [
{
"AssetId": "753ec868-060a-4469-b2cd-9a57fd537191",
"CreatedDate": "",
"ModelId": "",
"CategoryId": "",
"AssetTypeId": "",
"OwnerId": "",
"AssetTag": "",
"SerialNumber": "",
"ModelName": ""
}
]
}
Here is the screenshot of the ticket with the asset attached to it.
+2Yea, that doesn’t happen at all . . . . I have the AssetID (guid) and never attaches to the ticket/asset . . . I can go in and see my assets and attach after ticket created but for some reason it’s not attaching right then.
curl --location 'https://yourdistrict.incidentiq.com/api/v1.0/tickets/new' \
--header 'accept: application/json, text/plain, */*' \
--header 'accept-language: en-US,en;q=0.9' \
--header 'client: WebBrowser' \
--header 'content-type: application/json' \
--header 'user-agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/109.0.0.0 Safari/537.36' \
--header 'Authorization: Bearer [ENTER TOKEN HERE]' \
--data '{
"Subject": "Employee Device - Windows - Testing",
"IssueDescription": "Testing with Asset attached to the record",
"OwnerId": "deaf4603-88d3-4ad6-a343-83c162205ca9",
"ForId": "deaf4603-88d3-4ad6-a343-83c162205ca9",
"IssueId": "363e2521-bfde-ed11-9f72-6045bd85ef2b",
"TicketFollowerUserIds": [
""
],
"Assets": [
{
"AssetId": "753ec868-060a-4469-b2cd-9a57fd537191",
"CreatedDate": "",
"ModelId": "",
"CategoryId": "",
"AssetTypeId": "",
"OwnerId": "",
"AssetTag": "",
"SerialNumber": "",
"ModelName": ""
}
]
}'
+1$data = ['Assets' => ['AssetId' => ‘asdfasdf'], 'IssueId' => 'asdfasdfe', 'IssueDescription' => 'Some hardware issue here', 'AssignedToTeamId' => 'asdfasdf', 'ForID' => 'asdfsafde','LocationId'=>'asdf']; $response = Http::withToken(env('INCIDENT_IQ_TOKEN'))->post(env('INCIDENT_IQ_ADDRESS').'/tickets/new',$data);
No error . . . just doesn’t assign to my asset
+2
$data =
[
'ForId' => $info[0]['OwnerId'], // client id
'LocationId' => $info[0]['LocationId'], // client location
'IssueId' => 'xxx', // damaged
'AssignedToTeamId' => 'xxx', // hardware team
'AgentLocationId' => 'xxx', // tech center location
'ItemDescription' => 'Device Envoy - Marked broken - '. $info[0]['AssetTag'],
'AgentUserId' => auth()->user()->iq_agent_id,
'Tags' => array(['TagID' => 'xxx', 'Name' => 'ticket creator' ]),
'Assets' => array(['AssetId' => $info[0]['AssetId'], 'AssetTag' => $info[0]['AssetTag']])
];And then in the send statement (using Laravel / HTTP call):
$response = Http::withToken(env('INCIDENT_IQ_TOKEN'))
->withHeaders(['Content-Type' => 'application/json',
'Accept' => 'application/json',
'Accept-language' => 'en-US,en;q=0.9',
'SiteId' => 'xxx',
'ProductID' => 'xxx',
'ApiFlags' => 'OnlySetMappedProperties'])
->withBody(json_encode($data), 'application/json')
->post(env('INCIDENT_IQ_ADDRESS').'/tickets/new');
+18Enter your E-mail address. We'll send you an e-mail with instructions to reset your password.
