Skip to main content
POST
/
api
/
tickets
Créer un ticket
curl --request POST \
  --url https://app.xalantis.com/api/tickets \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "subject": "<string>",
  "description": "<string>",
  "requester_email": "<string>",
  "requester_name": "<string>",
  "priority": "<string>",
  "category_id": 123,
  "category_slug": "<string>",
  "channel": "<string>",
  "custom_fields": {}
}
'
{
  "message": "Ticket créé avec succès.",
  "ticket": {
    "uuid": "0b8a94c4-d27d-47e0-b57f-3a1a327f3279",
    "reference": "PAR1-000068",
    "subject": "Problème de connexion",
    "description": "Je n'arrive pas à me connecter à mon compte.",
    "status": "open",
    "priority": "high",
    "category": null,
    "channel": "api",
    "requester": {
      "type": "email",
      "name": "Jean Dupont",
      "email": "client@example.com",
      "phone": null,
      "contact_id": null,
      "client_id": null
    },
    "assignee": null,
    "parent_uuid": null,
    "custom_fields": {
      "os_version": "14.2"
    },
    "tags": [],
    "due_at": "2026-01-14T12:00:00.000000Z",
    "created_at": "2026-01-12T12:00:00.000000Z",
    "updated_at": "2026-01-12T12:00:00.000000Z",
    "resolved_at": null,
    "closed_at": null
  }
}

​
Authentification

Cette API nécessite une clé API. Incluez votre clé dans le header Authorization : 
Authorization: Bearer sk_live_XXXXXXXXXX
Vous pouvez générer une clé API dans Paramètres > Développeurs.
L’API est disponible uniquement pour les plans Pro et Entreprise. Les utilisateurs du plan Startup recevront une erreur 403.

​
Corps de la requête

​
subject
string
required
Le sujet du ticket. Maximum 255 caractères.
​
description
string
required
La description détaillée du problème ou de la demande.
​
requester_email
string
required
L’email du demandeur. Doit être une adresse email valide.
​
requester_name
string
Le nom du demandeur.
​
priority
string
default:"medium"
La priorité du ticket. Si non fournie, utilise la priorité par défaut configurée. Valeurs possibles : low, medium, high, urgent
​
category_id
integer
L’ID de la catégorie du ticket. Doit correspondre à une catégorie existante.
Vous pouvez utiliser category_id OU category_slug, pas les deux.
​
category_slug
string
Le slug de la catégorie du ticket. Alternative plus lisible à category_id. Slugs disponibles par défaut : bug, question, feature, billing, other, onboarding, offboarding, call, email, meeting, reminder
​
channel
string
default:"api"
Le canal d’origine du ticket. Valeurs possibles : api, email, phone, chat, web, widget
​
custom_fields
object
Un objet JSON contenant les champs personnalisés (clé: valeur).Exemple: {"os_version": "14.2", "device_model": "iPhone 13"}

​
Réponse

​
message
string
Message de confirmation.
​
ticket
object
{
  "message": "Ticket créé avec succès.",
  "ticket": {
    "uuid": "0b8a94c4-d27d-47e0-b57f-3a1a327f3279",
    "reference": "PAR1-000068",
    "subject": "Problème de connexion",
    "description": "Je n'arrive pas à me connecter à mon compte.",
    "status": "open",
    "priority": "high",
    "category": null,
    "channel": "api",
    "requester": {
      "type": "email",
      "name": "Jean Dupont",
      "email": "client@example.com",
      "phone": null,
      "contact_id": null,
      "client_id": null
    },
    "assignee": null,
    "parent_uuid": null,
    "custom_fields": {
      "os_version": "14.2"
    },
    "tags": [],
    "due_at": "2026-01-14T12:00:00.000000Z",
    "created_at": "2026-01-12T12:00:00.000000Z",
    "updated_at": "2026-01-12T12:00:00.000000Z",
    "resolved_at": null,
    "closed_at": null
  }
}

​
Exemples

curl -X POST "https://app.xalantis.com/api/tickets" \
  -H "Authorization: Bearer sk_live_XXXXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{
    "subject": "Problème de connexion",
    "description": "Je n'\''arrive pas à me connecter à mon compte.",
    "requester_email": "client@example.com",
    "requester_name": "Jean Dupont",
    "priority": "high",
    "custom_fields": {
      "os_version": "14.2"
    }
  }'

​
Fonctionnalités automatiques

Si une politique SLA correspond à la priorité et/ou catégorie du ticket, la date d’échéance (due_at) sera automatiquement calculée.
Si l’auto-assignation est activée dans vos paramètres, un agent sera automatiquement assigné selon la méthode configurée (round-robin, least-busy, ou random).
Si la catégorie spécifiée a une équipe par défaut configurée, le ticket sera automatiquement assigné à cette équipe.