Gestionar Comunidades de X

GET

/api/v1/social/accounts/{accountId}/x-communities

Lista las Comunidades guardadas para una cuenta de X conectada.

Petición

Usa el ID de una cuenta de X obtenido mediante Listar Cuentas.

curl -H "x-api-key: <apiKey>" \
  https://dopost.co/api/v1/social/accounts/<xAccountId>/x-communities

curl -H "x-api-key: <apiKey>" \
  https://dopost.co/api/v1/social/accounts/<xAccountId>/x-communities

Respuesta

200 OK

{
  "account": {
    "id": "<xAccountId>",
    "platform": "X",
    "platformUsername": "creator"
  },
  "communities": [
    {
      "communityId": "1493446837214187523",
      "name": "Builders Community",
      "description": "Una Comunidad para builders",
      "thumbnailUrl": "https://media.dopost.co/x-communities/example.webp",
      "isValid": true,
      "lastError": null,
      "lastVerifiedAt": "2026-09-13T18:00:00.000Z",
      "lastUsedAt": "2026-09-13T18:00:00.000Z"
    }
  ]
}

{
  "account": {
    "id": "<xAccountId>",
    "platform": "X",
    "platformUsername": "creator"
  },
  "communities": [
    {
      "communityId": "1493446837214187523",
      "name": "Builders Community",
      "description": "Una Comunidad para builders",
      "thumbnailUrl": "https://media.dopost.co/x-communities/example.webp",
      "isValid": true,
      "lastError": null,
      "lastVerifiedAt": "2026-09-13T18:00:00.000Z",
      "lastUsedAt": "2026-09-13T18:00:00.000Z"
    }
  ]
}

Elige una entrada con isValid: true y pasa su communityId al endpoint Publicar Post:

{
  "accountId": "<xAccountId>",
  "text": "Actualización para la Comunidad",
  "platformOptions": {
    "communityId": "1493446837214187523",
    "shareWithFollowers": false
  }
}

{
  "accountId": "<xAccountId>",
  "text": "Actualización para la Comunidad",
  "platformOptions": {
    "communityId": "1493446837214187523",
    "shareWithFollowers": false
  }
}

Un array communities vacío significa que todavía no se ha guardado ninguna Comunidad para esa cuenta de X. Las Comunidades se guardan desde el composer de dopost.

Añadir una Comunidad

Envía un ID numérico o una URL de Comunidad en x.com. dopost valida la Comunidad, guarda sus metadatos y almacena su thumbnail. Añadir de nuevo la misma Comunidad no crea un duplicado.

curl -X POST \
  -H "x-api-key: <apiKey>" \
  -H "Content-Type: application/json" \
  -d '{"community":"https://x.com/i/communities/1493446837214187523"}' \
  https://dopost.co/api/v1/social/accounts/<xAccountId>/x-communities

curl -X POST \
  -H "x-api-key: <apiKey>" \
  -H "Content-Type: application/json" \
  -d '{"community":"https://x.com/i/communities/1493446837214187523"}' \
  https://dopost.co/api/v1/social/accounts/<xAccountId>/x-communities

La respuesta usa 201 Created para una Comunidad nueva y 200 OK cuando ya estaba guardada.

Eliminar una Comunidad

Envía communityName o communityId. El nombre se acepta cuando identifica de forma única una Comunidad guardada.

curl -X DELETE \
  -H "x-api-key: <apiKey>" \
  -H "Content-Type: application/json" \
  -d '{"communityName":"Builders Community"}' \
  https://dopost.co/api/v1/social/accounts/<xAccountId>/x-communities

curl -X DELETE \
  -H "x-api-key: <apiKey>" \
  -H "Content-Type: application/json" \
  -d '{"communityName":"Builders Community"}' \
  https://dopost.co/api/v1/social/accounts/<xAccountId>/x-communities

Respuestas de error

Estado	Error	Causa
400	`Saved X Communities are supported only for X accounts`	La cuenta seleccionada pertenece a otra plataforma
400	`Use either communityName or communityId`	La eliminación no incluye selector o incluye ambos
401	`Invalid or missing API key`	La cabecera `x-api-key` es incorrecta o está ausente
403	`API credential does not have permission for this action`	Falta `social:accounts` para listar o `posts:create` para realizar cambios
404	`Account not found`	La cuenta no existe, está inactiva o pertenece a un workspace inaccesible
409	`More than one saved X Community has this name`	Usa `communityId` para distinguir qué Comunidad eliminar
502	Error de validación del proveedor	X no pudo validar la Comunidad al añadirla
429	`Rate limit exceeded`	Se realizaron demasiadas peticiones