---
title: "Read, query, preview, validate or export owned marketing data"
method: POST
path: "/api/mcp/tools/read_marketing"
tags: ["tools"]
---

# Read, query, preview, validate or export owned marketing data

`POST /api/mcp/tools/read_marketing`

## Request

- Base URL: `https://finestructure.ai`
- URL: `https://finestructure.ai/api/mcp/tools/read_marketing`
- Auth: HTTP bearer

Read, query, preview, validate or export owned marketing data. Never sends a message. Uses the same engine as /audiences. Call get_marketing_capabilities(operation=...) for the native parameters, including body when required.

## Request body

- object
  - `operation` 'activity.list' | 'analytics' | 'analytics.explore' | 'assistant.approvals' | 'automations.list' | 'campaigns.get' | 'campaigns.list' | 'campaigns.message' | 'campaigns.recipients' | 'campaigns.scheduled' | 'contacts.export' | 'contacts.get' | 'contacts.history' | 'contacts.list' | 'contacts.preview' | 'contacts.query' | 'contacts.tags' | 'dashboard' | 'data.get' | 'data.history' | 'data.preview' | 'drafts.get' | 'drafts.list' | 'email.experiment' | 'email.gmail.connections' | 'email.policy.get' | 'email.preview' | 'email.senders' | 'email.templates.list' | 'events.history' | 'events.preview' | 'events.revisions' | 'events.sources' | 'flows.get' | 'flows.list' | 'flows.validate' | 'folders.list' | 'inbox.capabilities' | 'inbox.conversations' | 'inbox.media' | 'inbox.messages' | 'library.list' | 'lists.list' | 'notifications.status' | 'permissions.history' | 'permissions.list' | 'reply_rules.list' | 'reports.get' | 'settings.get' | 'sms.connections' | 'sms.senders' | 'views.get' | 'whatsapp.accounts' | 'whatsapp.senders' | 'whatsapp.templates.list' | 'whatsapp.templates.preview', required
  - `parameters` object: Exact native parameters from capability discovery; omit for parameterless operations.

## Response `200`

Tool executed successfully

- ToolResult
  - `ok` boolean, required
  - `tool` string, required
  - `result` object, required

## Other responses

- `400`: Invalid arguments for this tool
- `401`: Missing or invalid bearer token
- `402`: Not enough credits on the account
- `403`: Token scope does not permit this tool
- `404`: Unknown tool name
- `429`: Rate limit exceeded, retry after the indicated delay
- `500`: Internal error while executing the tool

---

[API](https://skmtc.dev/finestructure/apis/fine-structure-api.md) · [All operations](https://skmtc.dev/finestructure/apis/fine-structure-api/llms.txt) · [OpenAPI document](https://skmtc.dev/finestructure/apis/fine-structure-api/revisions/02c50ed5fd70?raw)