---
title: "Create Entity Ingestion Config"
method: POST
path: "/v2/entity-ingestion-configs"
tags: ["Entity Ingestion Config API"]
---

# Create Entity Ingestion Config

`POST /v2/entity-ingestion-configs`

Create an entity ingestion config that links a workflow to an entity type for periodic data synchronization.

## Request body

- SvstorePublicapiCreateEntityIngestionConfigRequest
  - `teamId` string — The ID of the team.
  - `appInstanceId` string — The ID of the app instance (e.g., a ServiceNow connection).
  - `workflowId` string — The ID of the workflow that performs the entity sync.
  - `enabled` boolean, nullable — Whether the ingestion config is enabled. Defaults to true.
  - `syncDeletions` boolean, nullable — Whether to sync deletions. Defaults to false.
  - `internalEntityTypeId` string — The entity type ID that this ingestion populates.
  - `initialFieldMappings` SvstorePublicapiInitialFieldMapping[] — Optional initial field mappings to create alongside the ingestion config. When provided, field mappings are created automatically so data flows from external fields into entity type fields without requiring separate inference or manual configuration.
    - `internalFieldId` string — The ID of the internal entity type field to map to.
    - `externalFieldPath` string — The path in the external data to extract the value from (e.g., "active", "type").
  - `syncIntervalSeconds` union — Minimum interval between scheduled syncs, in seconds. Unset means "auto" (platform default cadence).
    - integer
    - string, int64

## Response `200`

Success

- SvstorePublicapiCreateEntityIngestionConfigResponse
  - `data` SvstoreIngestionConfig — Entity ingestion configuration for ETL extraction workflows
    - `id` string
    - `appInstanceId` string
    - `workflowId` string
    - `enabled` boolean
    - `createdAt` string, date-time — A timestamp in RFC 3339 format (e.g., "2025-01-15T01:30:15Z").
    - `updatedAt` string, date-time — A timestamp in RFC 3339 format (e.g., "2025-01-15T01:30:15Z").
    - `teamId` string
    - `serviceName` string, nullable
    - `workflowName` string, nullable
    - `isWorkflowPublished` boolean — Whether the linked workflow has been published/deployed.
    - `hasIngestionContext` boolean — Whether the linked workflow references context.CurrentIngestion.
    - `syncDeletions` boolean
    - `internalEntityTypeId` string
    - `syncIntervalSeconds` union — Customer-configured minimum interval between scheduled syncs, in seconds. Unset means "auto": the platform default cadence and full/delta heuristics apply.
      - integer
      - string, int64

## Other responses

- `default` — Error

---

[API](https://skmtc.net/serval/apis/serval-public-api.md) · [All operations](https://skmtc.net/serval/apis/serval-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/serval/serval-public-api/versions/0549515e9384/schema)