Create Ticket

All API requests should contain authorization headers.

Request

POST /tickets

Query Parameters.

This endpoint doesn't require query parameters.

Request Body

{
"Attachments": [{
"Url": "https://your.attachment.url/filename.png",
"Name": "filename.png"
}
],
"CategoryId": 15597,
"Cc": ["[email protected]"],
"Creator": {
"Name": "Bill Smith",
"Email": "[email protected]",
"Image": null,
"PhoneNumber": null
},
"CustomFields": [{
"Id": 42623,
"Value": "Oslo"
}
],
"Message": "Hello I want to buy a new car, how can I get a price list?",
"Sentiment": "question",
"Tags": [],
"Title": "New car price list."
}

Body of request should contain the following model serialized to JSON.

Field

Type

Comments

Attachments

array of Base Attachment models

Ticket Attachments

CategoryId

nullabe integer

Unique Id of category ticket should belong to. If value is null ticket will be created uncategorized

Cc

Array of strings

CC emails of ticket. Team member replies will be sent not only to ticket author but also to these emails

Creator

Ticket Creator

model contains ticket creator data.

CustomFields

array of Custom Field Id and Value models

List of models containing custom field ids and values.

Message

string

Ticket message

Sentiment

string

Sentiment of ticket. Can be question, praise, suggestion, complaint.

SourceName

string

Name of ticket source. Can have any string as value (for example page or channel name).

Tags

array of string

Ticket tags' names

Title

string

Title of the ticket

Response

{
"data": 4484636,
"errorCode": -1,
"errorText": null
}

Data field will contain ticket Id (type integer).