Svit.One Docs
Reference

External data ingestion

Processes a data ingestion job for the given `integrationId`. The request body is forwarded as raw JSON and processed asynchronously. Server token is required (project access token in the `Authorization` header).

POST/v1/external/data-ingestion/:integrationId

Processes a data ingestion job for the given integrationId. The request body is forwarded as raw JSON and processed asynchronously. Server token is required (project access token in the Authorization header).

Path Parameters

integrationId*string

Integration identifier

Header Parameters

authorization*string

Server token (project access token) in Bearer format, e.g. Bearer <token>

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

body?unknown

Raw JSON payload to enqueue for ingestion (structure depends on integration)

Response Body

application/json

curl -X POST "https://api-external.svit.one/api/v1/external/data-ingestion/:integrationId" \  -H "authorization: string"
{
  "message": "string"
}
{
  "type": "https://api-errors.svit.one/validation/integration-type-not-supported",
  "title": "Integration Type Not Supported",
  "status": 400,
  "detail": "Integration type 'OTHER' is not supported",
  "code": "INTEGRATION_TYPE_NOT_SUPPORTED",
  "timestamp": "2026-04-23T18:30:54.062Z"
}
{
  "type": "https://api-errors.svit.one/not-found/integration",
  "title": "Integration Not Found",
  "status": 404,
  "detail": "Integration with ID integration-id not found",
  "code": "INTEGRATION_NOT_FOUND",
  "timestamp": "2026-04-23T18:30:54.062Z"
}
{
  "type": "https://api-errors.svit.one/internal/server-error",
  "title": "Internal Server Error",
  "status": 500,
  "detail": "An unexpected error occurred",
  "code": "INTERNAL_SERVER_ERROR",
  "timestamp": "2026-04-23T18:30:54.062Z"
}

External API ping GET

Health check endpoint for the external integration API. Returns `OK` / `Pong`. Server token is required (project access token in the `Authorization` header).

Submit external form POST

Submit a contact form from an external website. Creates a new person record in the CRM system. Requires a valid client token in the x-client-token header.