Inicio rápido

Crear, actualizar y eliminar listas

Esta guía te mostrará cómo crear, actualizar y eliminar Listas.

Requisitos previos

Antes de comenzar, necesitarás:

• Una cuenta de desarrollador con una App aprobada
• Un token de acceso de usuario (OAuth 1.0a o OAuth 2.0 PKCE)

---

​

Crear una Lista

1. Prepara tu solicitud

   Define el nombre de la Lista (obligatorio) y, de forma opcional, la descripción y la configuración de privacidad:

   {
     "name": "Tech News",
     "description": "Top tech journalists and publications",
     "private": false
   }
   
2. Envía la solicitud

   cURL

   shellscript

   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. Revisa la respuesta

   {
     "data": {
       "id": "1441162269824405510",
       "name": "Tech News"
     }
   }
   

   Guarda el id para poder actualizar o eliminar la Lista más adelante.

---

​

Actualizar una Lista

Actualiza el nombre, la descripción o la privacidad de una Lista:

cURL

shellscript

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"
  }'

Respuesta:

{
  "data": {
    "updated": true
  }
}

---

​

Eliminar una Lista

1. Obtener el ID de la Lista

   Necesitas el ID de la Lista que quieres eliminar.

2. Enviar la solicitud de eliminación

   cURL

   shellscript

   curl -X DELETE "https://api.x.com/2/lists/1441162269824405510" \
     -H "Authorization: Bearer $USER_ACCESS_TOKEN"
   
3. Confirmar la eliminación

   {
     "data": {
       "deleted": true
     }
   }
   

Solo puedes eliminar las Listas de las que seas propietario.

---

​

Próximos pasos

Miembros de la Lista

Agregar y eliminar miembros de la Lista

Consulta de Listas

Obtener detalles de la Lista

Guía de integración

Conceptos clave y buenas prácticas

Referencia de la API

Documentación completa del endpoint