---
title: "Push paginated entities into an active session"
method: POST
path: "/{version}/integrations/{integration_id}/sessions/{session_id}/entities"
tags: ["Pushing Entities Data"]
---

# Push paginated entities into an active session

`POST /{version}/integrations/{integration_id}/sessions/{session_id}/entities`

Sends a page of entities (e.g., 100 items). Valid batches are **staged** until the session is closed as `apply`.

## Path parameters

- `version` 'v1', required
- `integration_id` string, required
- `session_id` string, required

## Request body

- EntitiesEnvelope
  - `entities` object, required — A map of entity type to an array of entity objects.

## Response `202`

Batch accepted and staged

- BatchIngestResponse
  - `session_id` string, required
  - `accepted_count_total` integer, required
  - `accepted_count_by_entity` object
  - `rejected_count_total` integer
  - `validation_errors` object[]
    - `entity_type` string
    - `index` integer
    - `field` string
    - `issue` string
  - `echoes` object
    - `page_hint` integer, nullable

## Other responses

- `400` — Validation error; batch rejected
- `401` — Unauthorized
- `404` — Session not found
- `409` — Session not active
- `429` — Too Many Requests

---

[API](https://skmtc.dev/sprinto/apis/sprinto-custom-integration-entities-sync-api.md) · [All operations](https://skmtc.dev/sprinto/apis/sprinto-custom-integration-entities-sync-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sprinto/apis/sprinto-custom-integration-entities-sync-api/revisions/270aadbb0f41?raw)