Skip to main content

Integration Framework Endpoints (cont.)

IntegrationDelta (continued)

DELETE /IntegrationDelta/{id}

Delete a delta record.

ParameterTypeDescription
idinteger (path, required)Delta record ID

IntegrationError

Logs errors encountered during integration sync operations.

GET /IntegrationError

List integration errors. Returns multiple IntegrationError records.

ParameterTypeDescription
countintegerMax number to return
detail_idintegerFilter by integration detail ID
module_idintegerFilter by integration module ID
orderorder5stringSort fields (up to 5)
orderdescorderdesc5booleanSort descending for each order field
page_nointegerPage number
page_sizeintegerRecords per page
pageinatebooleanEnable pagination

POST /IntegrationError

Create integration error records.

Request body: Array of IntegrationError objects.

GET /IntegrationError/{id}

Get a single integration error.

ParameterTypeDescription
idinteger (path, required)Error record ID
includedetailsbooleanInclude full detail fields

DELETE /IntegrationError/{id}

Delete an integration error record.

ParameterTypeDescription
idinteger (path, required)Error record ID

IntegrationExport

Manages queued export jobs — records staged for export from HaloPSA to an integration.

GET /IntegrationExport

List pending or completed export records.

ParameterTypeDescription
moduleIdintegerFilter by integration module
readyForImportbooleanFilter to records ready to import into the remote system

POST /IntegrationExport

Queue export records.

Request body: Array of IntegrationExport objects.

DELETE /IntegrationExport/{id}

Delete an export record.

ParameterTypeDescription
idinteger (path, required)Export record ID

IntegrationFieldData

Stores field-level data for integration records (raw mapped field values).

GET /IntegrationFieldData

List all integration field data records.

No query parameters documented.

POST /IntegrationFieldData

Create or update field data records.

Request body: Array of IntegrationFieldData objects.

GET /IntegrationFieldData/{id}

Get a single field data record.

ParameterTypeDescription
idinteger (path, required)Field data record ID

DELETE /IntegrationFieldData/{id}

Delete a field data record.

ParameterTypeDescription
idinteger (path, required)Field data record ID

IntegrationFieldMapping

Manages field-level mappings between HaloPSA fields and third-party integration fields.

GET /IntegrationFieldMapping

List integration field mappings.

ParameterTypeDescription
msidstringIntegration module/source ID
product_idintegerFilter by product
subtypeidstringSub-type filter
syncfieldsbooleanReturn only sync-enabled fields
typeidstringType filter
xmvaluestringExternal mapping value filter

IntegrationLookUp

Stores lookup/mapping tables used during integration data sync.

GET /IntegrationLookUp

List all lookup entries.

No query parameters documented.

POST /IntegrationLookUp

Create or update lookup entries.

Request body: Array of IntegrationLookUp objects.


IntegrationRequest

Logs inbound and outbound API requests made during integration sync. Useful for diagnostics and debugging.

GET /IntegrationRequest

List integration request logs.

ParameterTypeDescription
countintegerMax records to return
detail_idintegerFilter by integration detail
inbound_onlybooleanReturn only inbound requests
outbound_onlybooleanReturn only outbound requests
module_idintegerFilter by module
orderorder5stringSort fields
orderdescorderdesc5booleanSort descending
page_nointegerPage number
page_sizeintegerPage size
pageinatebooleanEnable pagination

POST /IntegrationRequest

Create request log entries.

Request body: Array of IntegrationRequest objects.

GET /IntegrationRequest/{id}

Get a single request log entry.

ParameterTypeDescription
idinteger (path, required)Request log ID
includedetailsbooleanInclude full details

DELETE /IntegrationRequest/{id}

Delete a request log entry.

ParameterTypeDescription
idinteger (path, required)Request log ID

IntegrationRunbookVariableGroup

Manages variable groups for integration runbooks (automation playbooks).

GET /IntegrationRunbookVariableGroup

List all runbook variable groups.

ParameterTypeDescription
exclude_method_idbooleanExclude method ID from results
one_runbook_idstringFilter to a specific runbook

GET /IntegrationRunbookVariableGroup/{id}

Get a single runbook variable group.

ParameterTypeDescription
idstring (path, required)Variable group ID
exclude_method_idintegerExclude a specific method ID
method_idsstringComma-separated list of method IDs to include

IntegrationSiteMapping

Maps third-party customer/site IDs to HaloPSA sites (clients).

GET /IntegrationSiteMapping

List site mappings.

ParameterTypeDescription
get_active_onlybooleanReturn only active mappings
msidintegerFilter by integration module source ID
third_party_client_idstringFilter by third-party client ID

IntegratorLog

Stores log entries produced by the HaloPSA integrator engine during sync runs.

GET /IntegratorLog

List integrator log entries.

ParameterTypeDescription
module_idintegerFilter by integration module
page_nointegerPage number
page_sizeintegerPage size
pageinatebooleanEnable pagination

IntegratorSchedule

Manages the scheduled sync times for integration modules.

GET /IntegratorSchedule

List integration sync schedules.

ParameterTypeDescription
page_nointegerPage number
page_sizeintegerPage size
pageinatebooleanEnable pagination

IntegratorTrace

Low-level trace data for integration sync operations (detailed request/response tracing).

GET /IntegratorTrace

List all trace records.

No query parameters documented.

GET /IntegratorTrace/{id}

Get a single trace record.

ParameterTypeDescription
idinteger (path, required)Trace record ID

ConnectedInstance

Manages connected HaloPSA instances (for multi-instance or parent-child Halo setups).

GET /ConnectedInstance

List all connected instances.

No query parameters documented.

POST /ConnectedInstance

Create or update connected instance records.

Request body: Array of ConnectedInstance objects.

GET /ConnectedInstance/{id}

Get a single connected instance.

ParameterTypeDescription
idinteger (path, required)Connected instance ID
includedetailsbooleanInclude full configuration details

DELETE /ConnectedInstance/{id}

Delete a connected instance.

ParameterTypeDescription
idinteger (path, required)Connected instance ID