Skip to main content
POST
/
tickets
/
{ticket_number}
/
drafts
Create a draft comment for a ticket
curl --request POST \
  --url https://{your-workspace}.neetodesk.com/api/v1/public/tickets/{ticket_number}/drafts \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <x-api-key>' \
  --data '{
  "content": "We are looking into the issue.",
  "comment_type": "note",
  "author_email": "oliver@example.com"
}'
{
  "id": "<string>",
  "comment_type": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "content": "<string>"
}
Replace {your-workspace} with your workspace’s subdomain.
Learn how to find your subdomain in Identifying your subdomain.

Headers

​
X-Api-Key
string
default:your-api-key
required

X-Api-Key is used to authenticate requests using an API key. Provide your API key in this header to access protected endpoints. Refer to Authentication for more information.

Path Parameters

​
ticket_number
number
required

Number of the ticket for the draft comment. Refer to Method 2 in the Getting Ticket ID section for instructions on how to find this number.

Body

application/json
​
content
string
required

Content for the draft comment. Cannot be blank.

Example:

"We are looking into the issue."

​
comment_type
enum<string>

Type of the comment. Defaults to reply.

Available options:
reply,
note
Example:

"note"

​
author_email
string

Optional email address of the person creating the draft. If provided, the signature stored in NeetoDesk for this user will be appended to the draft.

Example:

"oliver@example.com"

Response

200 - application/json

OK - Draft created successfully

​
id
string

Unique identifier for the draft

​
comment_type
string

The type of the comment

​
created_at
string<date-time>

Timestamp when the draft was created

​
updated_at
string<date-time>

Timestamp when the draft was last updated

​
content
string

Content of the draft comment

⌘I