Menu

Referência da API · Alertas

Contas de plataforma

alerts · target_platforms · 1 operação

GET/v1/alerts/target-platforms

List the platform accounts an alert can watch

alerts.target_platforms.list

LeituraIdempotenteDesde 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).

Escopo
alerts:read
Permissão
Ver o módulo
Tool do MCP
alerts_target_platforms_listNa superfície completa; na compacta, mb_execute_operation com id: "alerts.target_platforms.list".

Custo declarado: até 2 leituras e 0 escritas por chamada (contam na cota diária).

Parâmetros

target_org_idstringqueryopcional

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

Resposta

dataarray<object>

The connected platforms and their accounts.

Erros

Exemplo

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

Testar com a sua API key de teste

Com uma API key de teste o pedido vai sempre para a sua organização de prática: dados de exemplo que você pode reiniciar.

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