Truto · Schema

IntegratedAccount

An integrated account representing a connection between a Truto tenant and a customer's connected third-party application.

Unified APIIntegration PlatformHRISATSCRMEmbedded IntegrationsMCPAI AgentsSaaS

Properties

Name	Type	Description
id	string	Unique identifier for the integrated account.
integration	string	Integration name identifying the connected application (e.g., bamboohr, greenhouse, salesforce).
name	string	Human-readable display name for this integrated account.
status	string	Connection status of the integrated account.
context	object	Metadata stored from post-install actions, such as tenant ID, subdomain, region, or base URL from the underlying API.
externalId	string	Your internal identifier for the end user or organization that owns this connection.
createdAt	string	Timestamp when the account was connected.
updatedAt	string	Timestamp when the account was last updated.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://api.truto.one/schemas/integrated-account",
  "title": "IntegratedAccount",
  "description": "An integrated account representing a connection between a Truto tenant and a customer's connected third-party application.",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Unique identifier for the integrated account."
    },
    "integration": {
      "type": "string",
      "description": "Integration name identifying the connected application (e.g., bamboohr, greenhouse, salesforce)."
    },
    "name": {
      "type": "string",
      "description": "Human-readable display name for this integrated account."
    },
    "status": {
      "type": "string",
      "enum": ["active", "inactive", "error"],
      "description": "Connection status of the integrated account."
    },
    "context": {
      "type": "object",
      "additionalProperties": true,
      "description": "Metadata stored from post-install actions, such as tenant ID, subdomain, region, or base URL from the underlying API."
    },
    "externalId": {
      "type": "string",
      "description": "Your internal identifier for the end user or organization that owns this connection."
    },
    "createdAt": {
      "type": "string",
      "format": "date-time",
      "description": "Timestamp when the account was connected."
    },
    "updatedAt": {
      "type": "string",
      "format": "date-time",
      "description": "Timestamp when the account was last updated."
    }
  },
  "required": ["id", "integration", "status"]
}