---
title: "Export Lifecycle Contacts"
method: POST
path: "/lifecycle-contacts/export"
tags: ["Revenue Records"]
---

# Export Lifecycle Contacts

`POST /lifecycle-contacts/export`

## Request

- Base URL: `https://be.graph8.com/api/v1`
- URL: `https://be.graph8.com/api/v1/lifecycle-contacts/export`
- Auth: HTTP bearer

Download the stage Contacts grid as CSV: the same rows, order and visible columns the grid shows.

Locked contacts export masked, as on screen. Needs `data:export:bulk` (Owner and Admin have it) and an explicit
`contacts:run` grant; a key with no contact access is refused. The export is audited and alerts the admins.

## Headers

- `Authorization` string, nullable
- `X-Target-Org-Id` string, nullable

## Request body

- LifecycleContactsExportBody: The stage Contacts grid's view to export: columns, stage, filters, search and sort.
  - `columns` LifecycleContactsExportColumn[], required
    - `field` string, required: Row field, e.g. `email` or `company_name`.
    - `header` string, required: Column header as shown in the grid.
  - `lifecycle_id` string, required: Lifecycle stage the grid is scoped to.
  - `company_status` string, nullable
  - `search` string, nullable
  - `agFilterModel` object, nullable
  - `agSortModel` object[], nullable

## Response `200`

The stage Contacts grid as a CSV file

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/graph8/apis/graph8-developer-api.md) · [All operations](https://skmtc.dev/graph8/apis/graph8-developer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/graph8/apis/graph8-developer-api/revisions/2e7cfa0ca921?raw)