Menú

Referencia de la API · Alertas

Cuentas de plataforma

alerts · target_platforms · 1 operación

GET/v1/alerts/target-platforms

List the platform accounts an alert can watch

alerts.target_platforms.list

LecturaIdempotenteDesde 2026-11-01

Lists the platforms connected to the workspace or to one of its Accounts (target_org_id, default the workspace) that an alert can watch, each with its accounts: platform (google_ads, meta_ads, tiktok_ads, linkedin_ads, google_analytics, google_search_console, google_business_profile, facebook_page, instagram, linkedin_page, youtube, tiktok), platform_label and accounts (account_id, account_name). Use a platform and one of its account_ids in alerts.alerts.create. Reads only MB Suite (nothing is fetched from the platforms). Not paginated. 400 invalid_target when the organization is not this workspace or one of its Accounts the credential reaches. With Google Ads, Google Business Profile, LinkedIn, TikTok or YouTube, their terms limit it through the API and the MCP: what they do not allow answers 403 platform_terms_restricted, and their records are left out of the response (the permissions guide lists what each platform allows).

Alcance
alerts:read
Permiso
Ver el módulo
Tool del MCP
alerts_target_platforms_listEn la superficie completa; en la compacta, mb_execute_operation con id: "alerts.target_platforms.list".

Costo declarado: hasta 2 lecturas y 0 escrituras por llamada (cuentan en el cupo diario).

Parámetros

target_org_idstringqueryopcional

The watched organization: the workspace (default) or one of its Accounts.

Respuesta

dataarray<object>

The connected platforms and their accounts.

Errores

Ejemplo

curl "https://api.mb-suite.com/v1/alerts/target-platforms" \
  -H "Authorization: Bearer $MB_API_KEY"

Probar con tu API key de prueba

Con una API key de prueba el pedido va siempre a tu organización de práctica: datos de ejemplo que puedes reiniciar.

curl "https://api.mb-suite.com/v1/alerts/target-platforms" \
  -H "Authorization: Bearer $MB_TEST_KEY"