Connect
API REST

Consultar gasto diario por campaña en Meta

Lee el gasto y la entrega DIARIOS por campaña de la cuenta publicitaria de Meta de esta conexión, YA sincronizados. Sirve para atribuir gasto por campaña; para el total de la cuenta usa 'meta_ads.gasto_cuenta.consultar' y no sumes las dos, ni supongas que la suma de campañas cuadra con la cuenta (Meta puede no informar campañas eliminadas). Lectura pura: NO contacta a Meta ni dispara una sincronización. Revisa 'cobertura' antes de concluir que no hubo gasto. Las cifras son las que Meta informa en Insights: el gasto es estimado y NO equivale a facturas, cobros ni impuestos. No mezcles monedas. Para traer datos nuevos usa 'meta_ads.conexion.sincronizar'. Pagina con 'cursor'.

POST
/v1/tools/meta_ads.gasto_campanas.consultar/execute

Authorization

AuthorizationBearer <token>

API key de la organización, en 'Authorization: Bearer connect_sk_…'. Es la credencial para tu backend y tus agentes propios; se crea en el dashboard con permisos explícitos y su valor completo se muestra una sola vez. Autentica como agente: la bitácora atribuye la acción a la clave, nunca a la persona que la creó.

In: header

Header Parameters

X-Connect-Connection*string

Cuál conexión (conn_…) ejecuta esta llamada. Obligatoria en todo sistema conectable y sin resolución implícita, ni siquiera cuando la organización tiene una sola conexión activa: la conexión ES la empresa, y elegir por ti una que hoy acierta mañana acierta distinto sin que nadie cambie nada. Los ids salen de la tool 'conexiones.estado.consultar'. Si falta, la respuesta es 'validation_error' y no se contacta al sistema externo.

Match^conn_

Request Body

application/json

La entrada de la tool, envuelta en 'input'. Manda '{"input": {}}' cuando la tool no toma argumentos: el sobre es obligatorio aunque esté vacío.

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/tools/meta_ads.gasto_campanas.consultar/execute" \  -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \  -H "Content-Type: application/json" \  -d '{    "input": {}  }'
{  "data": {    "cuenta": {      "cuentaId": "string",      "moneda": "string",      "zonaHoraria": "string"    },    "filas": [      {        "campanaId": "string",        "campanaNombre": "string",        "fecha": "string",        "moneda": "string",        "zonaHoraria": "string",        "gasto": "string",        "impresiones": -9007199254740991,        "alcance": -9007199254740991,        "clics": -9007199254740991,        "clicsEnlace": -9007199254740991,        "diaCerrado": true,        "versionApi": "string",        "sincronizadoEn": "string"      }    ],    "cobertura": {      "desde": "string",      "hasta": "string",      "completa": true,      "diasSinLeer": [        {          "desde": "string",          "hasta": "string",          "motivo": "string"        }      ],      "pendiente": "presupuesto",      "sincronizadoEn": "string"    },    "cursor": "string"  },  "meta": {    "request_id": "string",    "operation_request_id": "733a3a71-b72d-4633-94b1-070c6664565f",    "tool_id": "string",    "plane": "action",    "latency_ms": 0,    "audit_status": "recorded",    "idempotency": "replayed"  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}

Verificar conexión Meta POST

Prueba las credenciales de la conexión contra Meta haciendo un login real (y su logout, a cargo del pipeline). No sincroniza ni devuelve datos: solo confirma si las credenciales sirven.

Consultar gasto diario de la cuenta publicitaria de Meta POST

Lee el gasto y la entrega DIARIOS de la cuenta publicitaria de Meta de esta conexión, YA sincronizados: gasto, impresiones, alcance y clics de cada día, con su moneda y la zona horaria de la cuenta. Es el total de la cuenta: no lo sumes con las filas por campaña. Lectura pura: NO contacta a Meta ni dispara una sincronización. Revisa 'cobertura' antes de concluir que no hubo gasto. Las cifras son las que Meta informa en Insights: el gasto es estimado y NO equivale a facturas, cobros ni impuestos. No mezcles monedas. Para traer datos nuevos usa 'meta_ads.conexion.sincronizar'. Pagina con 'cursor'.