Passer au contenu principal
Ce guide vous explique comment créer, mettre à jour et supprimer des listes.
PrérequisAvant de commencer, vous aurez besoin :
  • d’un compte développeur avec une App approuvée
  • d’un jeton d’accès utilisateur (User Access Token) (OAuth 1.0a ou OAuth 2.0 PKCE)

​
Créer une Liste

1

Préparer votre requête

Définissez le nom de la Liste (obligatoire), ainsi qu’éventuellement une description et des paramètres de confidentialité :
{
  "name": "Tech News",
  "description": "Top tech journalists and publications",
  "private": false
}
2

Envoyer la requête

cURL
curl -X POST "https://api.x.com/2/lists" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Tech News",
    "description": "Top tech journalists and publications",
    "private": false
  }'
3

Examiner la réponse

{
  "data": {
    "id": "1441162269824405510",
    "name": "Tech News"
  }
}
Enregistrez l’id afin de pouvoir mettre à jour ou supprimer la Liste ultérieurement.

​
Mettre à jour une liste

Modifiez le nom, la description ou les paramètres de confidentialité d’une liste :
cURL
curl -X PUT "https://api.x.com/2/lists/1441162269824405510" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Tech News & Insights",
    "description": "Updated description"
  }'
Réponse : 
{
  "data": {
    "updated": true
  }
}

​
Supprimer une Liste

1

Récupérer l'identifiant de la Liste

Vous avez besoin de l’identifiant de la Liste que vous souhaitez supprimer.
2

Envoyer la requête de suppression

cURL
curl -X DELETE "https://api.x.com/2/lists/1441162269824405510" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"
3

Confirmer la suppression

{
  "data": {
    "deleted": true
  }
}
Vous ne pouvez supprimer que les Listes que vous possédez.

​
Étapes suivantes

Membres de liste

Ajouter et supprimer des membres de liste

Recherche de liste

Récupérer les détails de la liste

Guide d’intégration

Concepts clés et bonnes pratiques

Référence de l’API

Documentation complète de l’endpoint