<!-- Generated by scripts/generate_endpoint_docs.py — do not edit by hand. -->
# `api.contacts.post_history`

> `POST /contacts/{contactId}/history` — ACPortal

**Python**

```python
api.contacts.post_history(contact_id: str, *, data: ContactHistoryCreateRequest | dict) -> ContactHistory
```

**CLI**

```bash
ab contacts post_history <contact_id> [--data ...]
```

POST /contacts/{contactId}/history.

Args:
    contact_id: Contact identifier.
    data: History creation payload.
        Accepts a :class:`ContactHistoryCreateRequest` instance or a dict.

Request model: :class:`ContactHistoryCreateRequest`

## Request body — `ContactHistoryCreateRequest`

| Field | Type | Required | Description |
|---|---|---|---|
| `statuses` | `Optional[str]` | no | Comma-separated status filters |

## Response

Returns `ContactHistory`.

| Field | Type | Required | Description |
|---|---|---|---|
| `events` | `Optional[list[dict]]` | no | History events |
| `totalCount` | `Optional[int]` | no | Total event count |

---

[← Back to api.contacts](../contacts.md)