---
title: "POST - Trigger a base records export"
method: POST
path: "/v2/exports/base_records"
tags: ["Exports"]
---

# POST - Trigger a base records export

`POST /v2/exports/base_records`

Queues a base records export on behalf of the teammate identified by `member_email`. When omitted under OAuth2 with an actor token, the authenticated user's email is used. The export will be sent to that member's email address. The export is filtered to the base record types that the member can access; if none of the requested `export_types` are accessible a 403 is returned.

## Request body

- object
  - `end_date` string, nullable — Optional filter (YYYY-MM-DD) to limit end date of exported records
  - `export_options` string[], nullable — Optional list of export types to include. When omitted, every export type the member has access to is included.
  - `group_keys` string[], nullable — Optional filter to limit exported report data to user selected groups. If not provided, all groups will be included.
  - `include_archived_partners` boolean, nullable — Whether archived partners should be included in the export
  - `member_email` string, email, nullable — The email of the company member that the export is being triggered on behalf of. When omitted, the authenticated OAuth user's email is used. The user must have an active membership in your PartnerStack company; permissions, feature access, and group access are evaluated against that membership.
  - `start_date` string, nullable — Optional filter (YYYY-MM-DD) to limit starting date of exported records
  - `timezone` string, nullable — IANA timezone identifier used to bucket start_date / end_date
  - `timezone_offset` integer, nullable — The end user's timezone offset in minutes, used for accurate datetime rendering in emails
  - `webhook_target_url` string, nullable — The webhook target URL to send the export to

## Response `200`

Queues a base records export on behalf of the teammate identified by `member_email`. When omitted under OAuth2 with an actor token, the authenticated user's email is used. The export will be sent to that member's email address. The export is filtered to the base record types that the member can access; if none of the requested `export_types` are accessible a 403 is returned.

- object
  - `data` object, required
    - `admin_user_key` string, nullable
    - `configuration` object, nullable
    - `created_at` integer
    - `error` string, nullable
    - `expires_at` integer, nullable
    - `exporter_key` string
    - `file_key` string, nullable
    - `file_name` string, nullable
    - `file_url` string, nullable
    - `files` object[], nullable
      - `key` string, nullable
      - `name` string, nullable
      - `url` string, nullable
    - `key` string
    - `parent_export_key` string, nullable — Key of the parent export (if this export is a child of a combined partnerships export)
    - `recipients` object, nullable
    - `report_config` object
    - `report_type` string
    - `retry_count` integer
    - `scheduler_key` string, nullable
    - `source` string
    - `status` string
    - `target_key` string
    - `updated_at` integer
    - `vendor_report_configuration_key` string, nullable
    - `webhook_target_url` string, nullable
    - `zip_file` object, nullable
      - `key` string, nullable
      - `name` string, nullable
      - `url` string, nullable
    - `zip_file_key` string, nullable
  - `message` string, required
  - `status` integer, required

## Other responses

- `400` — Bad Request Error
- `401` — Unauthorized Error
- `403` — Forbidden Error
- `404` — Not Found Error
- `500` — Internal Server Error

---

[API](https://skmtc.dev/partnerstack/apis/partnerstack-api.md) · [All operations](https://skmtc.dev/partnerstack/apis/partnerstack-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/partnerstack/partnerstack-api/revisions/0f35aebe53a9/schema)