​
Step 1: Make Your First API Call

Let’s create a ticket in your workspace using a POST request: 
curl -X POST "https://{your-workspace}.neetodesk.com/api/v1/public/tickets" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "customer@example.com",
    "subject": "My first API ticket",
    "description": "This ticket was created using the NeetoDesk API!"
  }'
Replace your-workspace with your workspace subdomain and your-api-key with your generated API key.

​
Step 2: Understanding the Response

A successful response will look like this JSON format: 
{
  "notice_code": "ticket_created_successfully",
  "ticket": {
    "id": "56e11f80-ff33-4d5c-9855-539c39246570",
    "number": 42,
    "url": "https://{your-workspace}.neetodesk.com/admin/tickets/42",
    "subject": "My first API ticket",
    "description": "This ticket was created using the NeetoDesk API!",
    "status": "open",
    "created_at": "2024-01-15T10:30:00Z"
  }
}

​
Next Steps

Now that you’ve made your first API call, you can:

Explore API reference

Browse available endpoints and their detailed documentation.

Pagination

Understand how to paginate through API responses efficiently.

HTTP response codes

Learn what different response codes mean and how to handle them.