# get_post_events

> Get a post's history with Wavegrain's MCP server: the get_post_events tool needs the read permission. Inputs, outputs and an example call.

> Index of these docs: https://wavegrain.com/developers/llms.txt

**Get a post's history.** Permission: `read`. Read-only: changes nothing.

One post's history from a get_post_status delivery id, oldest first: each step and network call with result and request id, and its state now with the reason.

## Inputs

| Input | Type | Required | Notes |
| --- | --- | --- | --- |
| `deliveryId` | string | yes | A delivery id from get_post_status. up to 200 characters |

The fields inside an object or a list are in the JSON Schema at [/developers/mcp-tools.json](/developers/mcp-tools.json).

## Returns

| Field | Type | Notes |
| --- | --- | --- |
| `deliveryId` | string | The delivery. |
| `network` | string | The network. |
| `accountName` | string \| null | The account it posts to. |
| `status` | "queued" \| "preparing" \| "sending" \| "processing" \| "action_required" \| "outcome_unknown" \| "published" \| "failed" \| "cancelled" | The post's status on this account: queued (waiting for its time), preparing and sending (on its way), processing (the network is processing it), action_required (waiting in the account's inbox; the person finishes it in the network's app), outcome_unknown (it may or may not have posted; the person checks, then marks it posted or sends it again), published, failed, cancelled. label is the same in words. |
| `automatic` | boolean | True when it posts by itself from the Calendar. |
| `scheduledFor` | string | When it posts or posted, ISO 8601. |
| `reason` | string \| null | Why it failed or is unconfirmed, in words the user can act on. |
| `events` | object[] | Oldest first. Network calls are kept 30 days. |

## Example call

Send it to `POST https://wavegrain.com/api/mcp` with an access key that has the `read` permission; [Authentication](/developers/authentication) shows how to make one.

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_post_events",
    "arguments": {
      "deliveryId": "<deliveryId>"
    }
  }
}
```

The call shows only the required inputs, with placeholder values: put your own in.

## Related tools

- [`list_accounts`](/developers/mcp-tools/list_accounts): List accounts and groups
- [`get_connect_link`](/developers/mcp-tools/get_connect_link): Get a link to connect an account
- [`get_post_status`](/developers/mcp-tools/get_post_status): Get a post's status
- [`search_inspiration`](/developers/mcp-tools/search_inspiration): Search the Inspiration library
- [`get_playbook`](/developers/mcp-tools/get_playbook): Get the slideshow playbook
- [`estimate_cost`](/developers/mcp-tools/estimate_cost): Estimate credits
- [All 79 tools](/developers/mcp-tools)
