/api/v4/connected-accounts/disconnect-facebookDesconectar una cuenta de Facebook
Desconecta una cuenta de Facebook Pages previamente conectada de tu cuenta de Listings API.
Parámetros
Cuerpo
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| input | object | obligatorio | Wrapper object. The entire request body must be nested under `input`. |
| input.connectedAccountId | string | obligatorio | UUID of the connected Facebook account to disconnect. The whole account is disconnected. |
Solicitud de ejemplo
Cuerpo listo para pegar. Sustituye los ID y valores de ejemplo por los tuyos.
{ "input": { "connectedAccountId": "d2397854-52c2-41d7-95f1-b90cba16498d" }}Respuestas
200Request accepted. `success: true` confirms the disconnect was processed.
{ "data": { "fbBulkDisconnect": { "success": true } }}400Bad request, the body was not wrapped in `input`, or `connectedAccountId` was omitted (error message: `Field value.connectedAccountId of required type String! was not provided`).
401Unauthenticated, missing or invalid API key.
Rompe el vínculo entre una cuenta de Facebook Pages conectada y tu cuenta de Listings API. Una vez desconectada, las fichas sincronizadas a través de esa cuenta dejan de recibir actualizaciones de Listings API y las interacciones de Facebook dejan de aparecer en el panel.
Estructura de la solicitud. El cuerpo debe estar incluido en un objeto input cuyo único campo sea connectedAccountId. Esta operación es de todo o nada: se desconecta la cuenta conectada en su totalidad. No hay ningún campo locationIds; el esquema lo rechaza. Para desvincular la ficha de una sola ubicación y mantener la cuenta conectada, utiliza el endpoint disconnect-listing.
Caso de uso: dar de baja a un cliente que se marcha. Cuando un cliente cancele, desconecta su cuenta de Facebook para que Listings API deje de gestionar sus páginas y no se envíen más publicaciones ni respuestas en su nombre. Proporciona el connectedAccountId del cliente (obtenido de GET /connected-accounts) para desvincular la cuenta por completo.
Caso de uso: volver a autorizar una conexión que falla. Si una conexión de Facebook presenta errores de credenciales que no se resuelven al volver a autenticarla, desconéctala aquí y genera un nuevo enlace con el endpoint connect-facebook. success: true confirma la desconexión. Para Google, utiliza el endpoint disconnect-google. Ten en cuenta que se devuelve una respuesta success: true incluso si el connectedAccountId es desconocido, así que interpreta el éxito como "la solicitud se ha procesado", no como prueba de que se haya eliminado una conexión activa; confirma el estado de la cuenta con GET /connected-accounts si necesitas tener certeza.
curl -X POST 'https://listingsapi.com/api/v4/connected-accounts/disconnect-facebook' \ -H "Authorization: API $LISTINGSAPI_KEY" \ -H 'Content-Type: application/json' \ -d '{ "input": { "connectedAccountId": "d2397854-52c2-41d7-95f1-b90cba16498d" } }'