Svit.One Docs
Reference

Submit external form

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.

POST/v1/external/client/form

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.

Header Parameters

x-client-token*string

Client token for project authentication

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

curl -X POST "https://api-external.svit.one/api/v1/external/client/form" \  -H "x-client-token: string" \  -H "Content-Type: application/json" \  -d '{    "name": "string",    "phone": "string"  }'
{
  "personId": "string",
  "opportunityId": "string",
  "message": "Form submitted successfully"
}
{
  "type": "https://api-errors.svit.one/validation/invalid-request",
  "title": "Validation Failed",
  "status": 400,
  "detail": "Phone is required",
  "code": "INVALID_REQUEST",
  "errors": [
    {
      "field": "phone",
      "message": "Phone is required"
    }
  ],
  "timestamp": "2026-08-25T21:18:32.007Z"
}
{
  "type": "https://api-errors.svit.one/external-client/invalid-token",
  "title": "Invalid Client Token",
  "status": 401,
  "detail": "The provided client token is invalid",
  "code": "INVALID_CLIENT_TOKEN",
  "timestamp": "2026-08-25T21:18:32.007Z"
}
{
  "type": "https://api-errors.svit.one/external-client/invalid-origin",
  "title": "Origin Not Allowed",
  "status": 403,
  "detail": "Origin 'https://example.com' is not allowed for this token",
  "code": "INVALID_CLIENT_ORIGIN",
  "timestamp": "2026-08-25T21:18:32.007Z"
}
{
  "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-08-25T21:18:32.007Z"
}

External data ingestion POST

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).

Update a task PATCH

Updates only the supplied fields on a task in the project associated with the bearer project access token. Pass null to clear a nullable field or an empty assigneeIds array to remove all assignees. The token creator's current task permissions apply.