--- updatedAt: 2026-09-17T05:35:22.000Z agentTools: projectIndex: https://docs.gtm.ai/llms.txt --- # Execute Export Executes an export against one or more ZoomInfo Person or Company IDs. You cannot pass both person and company IDs together — `object` says which kind `fields.id` holds. They're all handled together as a single run, not one at a time. Returns 202 Accepted with the newly created run, in `PENDING` status — check its status via [Get Execution Status](ref:ExportsController_getExecutionStatus). Returns 400 if `fields.id` is empty. Returns 404 if the export doesn't exist. Returns 422 if the export has been deactivated. [List Exports] (ref:ExportsController_listExports) does not return inactive exports, so this is most likely to happen when the export was deactivated after you listed it, or you're reusing a cached `exportId`. # OpenAPI definition ```json { "openapi": "3.0.0", "info": { "title": "Platform API V1", "version": "1.0", "contact": { "name": "ZoomInfo Customer Support", "email": "help@zoominfo.com" }, "description": "The Platform API" }, "tags": [ { "name": "Data Exports", "x-beta": true } ], "paths": { "/platform/v1/exports/{exportId}/actions/execute": { "post": { "operationId": "ExportsController_executeExport", "summary": "Execute Export", "description": "Executes an export against one or more ZoomInfo Person or Company IDs. You cannot pass both\nperson and company IDs together — `object` says which kind `fields.id` holds. They're all\nhandled together as a single run, not one at a time.\n\nReturns 202 Accepted with the newly created run, in `PENDING` status — check its status via\n[Get Execution Status](https://docs.gtm.ai/zoominfoenterprise/reference/ExportsController_getExecutionStatus).\nReturns 400 if `fields.id` is empty.\nReturns 404 if the export doesn't exist.\nReturns 422 if the export has been deactivated. [List Exports]\n(ref:ExportsController_listExports) does not return inactive exports, so this is most likely\nto happen when the export was deactivated after you listed it, or you're reusing a cached\n`exportId`.", "parameters": [ { "name": "exportId", "in": "path", "required": true, "description": "ID of the export to run", "schema": { "type": "string" } } ], "responses": { "202": { "description": "Accepted", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/ExecutionResponse" } } } }, "400": { "description": "Bad Request", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/ZoomInfo.Core.Foundations.ErrorResponseModel" } } } }, "401": { "description": "Unauthorized", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/ZoomInfo.Core.Foundations.ErrorResponseModel" } } } }, "403": { "description": "Forbidden", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/ZoomInfo.Core.Foundations.ErrorResponseModel" } } } }, "404": { "description": "Not Found", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/ZoomInfo.Core.Foundations.ErrorResponseModel" } } } }, "422": { "description": "Unprocessable Content", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/ZoomInfo.Core.Foundations.ErrorResponseModel" } } } }, "429": { "description": "Too Many Requests", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/ZoomInfo.Core.Foundations.ErrorResponseModel" } } } } }, "tags": [ "Data Exports" ], "requestBody": { "required": true, "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/ExecuteExportRequestBody" } } }, "description": "The ZoomInfo record IDs to run this export against" }, "security": [ { "OAuth2Auth": [ "api:central-export-service:execute" ] } ], "x-additional-content-types": [ "application/json" ], "x-beta": true } } }, "security": [ { "OAuth2Auth": [] } ], "components": { "schemas": { "ZoomInfo.Core.Foundations.ErrorSourceModel": { "type": "object", "properties": { "cookie": { "type": "string", "description": "Identifies the cookie name that caused the issue" }, "header": { "type": "string", "description": "Identifies the header name that caused the error" }, "pointer": { "type": "string", "description": "An RFC 6901 compliant JSON pointer to the entity in the request body that caused the error" }, "parameter": { "type": "string", "description": "The name of the path or query parameter that caused the error" } } }, "ZoomInfo.Core.Foundations.ErrorModel": { "type": "object", "required": [ "id", "code", "status" ], "properties": { "id": { "type": "string", "description": "The unique id used to identify this specific error instance" }, "code": { "type": "string", "description": "The error code describing the error category. A full list of error codes can be found in the documentation for each service" }, "detail": { "type": "string", "description": "Message containing the specific details about this occurrence of the error" }, "source": { "allOf": [ { "$ref": "#/components/schemas/ZoomInfo.Core.Foundations.ErrorSourceModel" } ], "description": "An optional object identifying which part of the request caused the error" }, "status": { "type": "string", "description": "The HTTP status code for the error" }, "title": { "type": "string", "description": "The error name that describes this type of error" } }, "description": "The object describing a specific error from the API" }, "ZoomInfo.Core.Foundations.ErrorResponseModel": { "type": "object", "required": [ "errors" ], "properties": { "detail": { "type": "string", "description": "A high-level detail of the error(s) that occurred during the request" }, "title": { "type": "string", "description": "A high-level summary of the error(s) detected" }, "errors": { "type": "array", "items": { "$ref": "#/components/schemas/ZoomInfo.Core.Foundations.ErrorModel" }, "description": "The list of errors raised during the request" } }, "description": "The standard error response body model for the ZoomInfo API." }, "ExecutionStatus": { "type": "string", "enum": [ "PENDING", "IN_PROGRESS", "COMPLETED", "FAILED", "STOPPED" ], "description": "Where a run currently stands." }, "ExecutionAttributes": { "type": "object", "required": [ "exportId", "status" ], "properties": { "exportId": { "type": "string", "description": "Which export this run used" }, "status": { "allOf": [ { "$ref": "#/components/schemas/ExecutionStatus" } ], "description": "Current status of this run" }, "error": { "type": "string", "description": "What went wrong, if the run failed or was stopped" } }, "description": "Status of an export run." }, "Execution": { "type": "object", "required": [ "id", "type", "attributes" ], "properties": { "id": { "type": "string", "description": "The unique identifier for the resource" }, "type": { "type": "string", "description": "The type of the resource", "default": "Execution", "pattern": "Execution" }, "attributes": { "allOf": [ { "$ref": "#/components/schemas/ExecutionAttributes" } ], "description": "The attributes defining the resource" } }, "description": "An export run, as a single API resource." }, "ExecutionResponse": { "type": "object", "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/Execution" } ], "description": "The primary data of the document" } }, "description": "Response containing a single run's status." }, "ExportObjectType": { "type": "string", "enum": [ "CONTACT", "COMPANY" ], "description": "Which kind of ZoomInfo record an execute call is sending — a person (`contact`) or a `company`." }, "ExecuteExportAttributes": { "type": "object", "required": [ "objectType", "ids" ], "properties": { "objectType": { "allOf": [ { "$ref": "#/components/schemas/ExportObjectType" } ], "description": "Whether `fields.id` are person (`contact`) or `company` IDs." }, "ids": { "type": "array", "items": { "type": "integer", "format": "int64" }, "maxItems": 50, "description": "ZoomInfo IDs of the records to send, e.g. `[123456789, 987654321]`. Up to 50 per call." } }, "description": "What to run an export against — one or more ZoomInfo record IDs, all handled together as a\nsingle run, not one at a time." }, "ExecuteExportRequest": { "type": "object", "required": [ "type", "attributes" ], "properties": { "type": { "type": "string", "description": "The type of the resource", "default": "ExecuteExportRequest", "pattern": "ExecuteExportRequest" }, "attributes": { "allOf": [ { "$ref": "#/components/schemas/ExecuteExportAttributes" } ], "description": "The attributes defining the resource" } }, "description": "A request to run an export, as a single API resource." }, "ExecuteExportRequestBody": { "type": "object", "required": [ "data" ], "properties": { "data": { "allOf": [ { "$ref": "#/components/schemas/ExecuteExportRequest" } ], "description": "The primary data of the document" } }, "description": "Request body for running an export." } }, "securitySchemes": { "OAuth2Auth": { "type": "oauth2", "flows": { "authorizationCode": { "authorizationUrl": "https://login.zoominfo.com", "tokenUrl": "https://okta-login.zoominfo.com/oauth2/default/v1/token", "scopes": { "api:gtm-data-model:read": "Ability to read GTM Data Model entities, schemas, and data", "api:gtm-data-model:manage": "Ability to manage GTM Data Model entities, schemas, and data", "api:workflows:read": "Read Workflows data", "api:workflows:execute": "Execute Workflows", "api:entitlement:read": "Read User entitlements", "api:central-export-service:read": "List and inspect available export destinations and their execution history", "api:central-export-service:execute": "Execute a destination to activate records into an external system" } } } } } }, "servers": [ { "url": "https://api.zoominfo.com/gtm", "description": "Base URL for the Platform API" } ] } ``` # Sibling pages * [List Exports](https://docs.gtm.ai/zoominfoenterprise/reference/exportscontroller_listexports.md) * [Get Export](https://docs.gtm.ai/zoominfoenterprise/reference/exportscontroller_getexport.md) * [Get Execution Status](https://docs.gtm.ai/zoominfoenterprise/reference/exportscontroller_getexecutionstatus.md)