Saltar al contenido principal
Esta guía te mostrará cómo crear, actualizar y eliminar Listas.
Requisitos previosAntes de comenzar, necesitarás:

​
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
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
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
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