Create a ticket
curl --request POST \
--url https://{your-subdomain}.neetodesk.com/api/v1/public/tickets \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <x-api-key>' \
--data '
{
"email": "john@example.com",
"subject": "How to resolve the pending payments",
"description": "I need your help in resolving the pending payments.",
"ticket_fields": {
"Country": "USA"
},
"name": "John Luther",
"channel": "email",
"to": "[\"eve@example.com\",\"kevin@example.com\"]",
"cc": "[\"eve@example.com\",\"kevin@example.com\"]",
"group": "sales",
"assignee_email": "oliver@example.com",
"status": "open",
"priority": "low",
"category": "Questions",
"sub_category_one": "Billing",
"sub_category_two": "Refund",
"tags": [
"refund",
"urgent"
],
"resolution_due_date": "2025-12-31T23:59:59Z"
}
'const options = {
method: 'POST',
headers: {'X-Api-Key': '<x-api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
email: 'john@example.com',
subject: 'How to resolve the pending payments',
description: 'I need your help in resolving the pending payments.',
ticket_fields: {Country: 'USA'},
name: 'John Luther',
channel: 'email',
to: '["eve@example.com","kevin@example.com"]',
cc: '["eve@example.com","kevin@example.com"]',
group: 'sales',
assignee_email: 'oliver@example.com',
status: 'open',
priority: 'low',
category: 'Questions',
sub_category_one: 'Billing',
sub_category_two: 'Refund',
tags: ['refund', 'urgent'],
resolution_due_date: '2025-12-31T23:59:59Z'
})
};
fetch('https://{your-subdomain}.neetodesk.com/api/v1/public/tickets', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://{your-subdomain}.neetodesk.com/api/v1/public/tickets"
payload = {
"email": "john@example.com",
"subject": "How to resolve the pending payments",
"description": "I need your help in resolving the pending payments.",
"ticket_fields": { "Country": "USA" },
"name": "John Luther",
"channel": "email",
"to": "[\"eve@example.com\",\"kevin@example.com\"]",
"cc": "[\"eve@example.com\",\"kevin@example.com\"]",
"group": "sales",
"assignee_email": "oliver@example.com",
"status": "open",
"priority": "low",
"category": "Questions",
"sub_category_one": "Billing",
"sub_category_two": "Refund",
"tags": ["refund", "urgent"],
"resolution_due_date": "2025-12-31T23:59:59Z"
}
headers = {
"X-Api-Key": "<x-api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"notice_code": "<string>",
"ticket": {
"id": "aaaabbbb-cccc-dddd-eeee-ffff00003333",
"number": 42,
"url": "https://example.neetodesk.com/admin/tickets/42"
}
}API v1 (deprecated)
Create ticket
Creates a new ticket.
POST
/
tickets
Create a ticket
curl --request POST \
--url https://{your-subdomain}.neetodesk.com/api/v1/public/tickets \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <x-api-key>' \
--data '
{
"email": "john@example.com",
"subject": "How to resolve the pending payments",
"description": "I need your help in resolving the pending payments.",
"ticket_fields": {
"Country": "USA"
},
"name": "John Luther",
"channel": "email",
"to": "[\"eve@example.com\",\"kevin@example.com\"]",
"cc": "[\"eve@example.com\",\"kevin@example.com\"]",
"group": "sales",
"assignee_email": "oliver@example.com",
"status": "open",
"priority": "low",
"category": "Questions",
"sub_category_one": "Billing",
"sub_category_two": "Refund",
"tags": [
"refund",
"urgent"
],
"resolution_due_date": "2025-12-31T23:59:59Z"
}
'const options = {
method: 'POST',
headers: {'X-Api-Key': '<x-api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
email: 'john@example.com',
subject: 'How to resolve the pending payments',
description: 'I need your help in resolving the pending payments.',
ticket_fields: {Country: 'USA'},
name: 'John Luther',
channel: 'email',
to: '["eve@example.com","kevin@example.com"]',
cc: '["eve@example.com","kevin@example.com"]',
group: 'sales',
assignee_email: 'oliver@example.com',
status: 'open',
priority: 'low',
category: 'Questions',
sub_category_one: 'Billing',
sub_category_two: 'Refund',
tags: ['refund', 'urgent'],
resolution_due_date: '2025-12-31T23:59:59Z'
})
};
fetch('https://{your-subdomain}.neetodesk.com/api/v1/public/tickets', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://{your-subdomain}.neetodesk.com/api/v1/public/tickets"
payload = {
"email": "john@example.com",
"subject": "How to resolve the pending payments",
"description": "I need your help in resolving the pending payments.",
"ticket_fields": { "Country": "USA" },
"name": "John Luther",
"channel": "email",
"to": "[\"eve@example.com\",\"kevin@example.com\"]",
"cc": "[\"eve@example.com\",\"kevin@example.com\"]",
"group": "sales",
"assignee_email": "oliver@example.com",
"status": "open",
"priority": "low",
"category": "Questions",
"sub_category_one": "Billing",
"sub_category_two": "Refund",
"tags": ["refund", "urgent"],
"resolution_due_date": "2025-12-31T23:59:59Z"
}
headers = {
"X-Api-Key": "<x-api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"notice_code": "<string>",
"ticket": {
"id": "aaaabbbb-cccc-dddd-eeee-ffff00003333",
"number": 42,
"url": "https://example.neetodesk.com/admin/tickets/42"
}
}Deprecated: This is a v1 endpoint. It will continue to work, but we
recommend migrating to the v2 equivalent for improved REST
compliance (correct HTTP status codes, consistent response envelopes, and
hyphenated URLs).
Replace
Learn how to find your subdomain in Workspace subdomain.
{your-subdomain} with your workspace’s subdomain. Learn how to find your subdomain in Workspace subdomain.
Headers
Use the X-Api-Key header to provide your workspace API key. Refer to Authentication for more information.
Body
application/json
Custom ticket fields. Refer to the ticket fields article for more details.
Example:
{ "Country": "USA" }
Name of an existing group.
Example:
"sales"