Skip to main content

Marketplace & Distribution Endpoints

Vendor Integrations: Marketplace & Distribution

This section covers HaloPSA integrations with third-party distribution and marketplace vendors including Pax8, Ingram Micro, Synnex, Arrow Sphere, StreamOne Ion, Tech Data, Datto Commerce, Adobe Commerce, Microsoft CSP, Amazon Seller, Shopify, and e-commerce order management.


Pax8Details

Manage Pax8 marketplace integration credentials and configuration.

GET /Pax8Details

List all Pax8 integration configurations. Requires authentication.

POST /Pax8Details

Create or update Pax8 integration configurations.

Request body: Array of Pax8Details

Pax8Details schema:

PropertyTypeDescription
idintegerRecord ID
guidstring (uuid)Integration GUID
urlstringPax8 API URL
new_client_secretstringClient secret (write-only)
tenantstringTenant identifier
new_access_tokenstringAccess token (write-only)
new_refresh_tokenstringRefresh token (write-only)
_exchangecodebooleanTrigger OAuth code exchange
new_methodbooleanUse new auth method
auth_typeintegerAuthentication type
environmentintegerEnvironment (sandbox/production)
import_inactive_and_deletedbooleanImport inactive/deleted records
import_usage_linesbooleanImport usage lines
allow_subscription_changesbooleanAllow subscription changes via portal
import_entitiesstringComma-separated entity types to import
import_entities_listarrayEntity import list (KeyPair2 objects)
top_levelintegerTop-level client ID
top_level_namestringTop-level client name
update_addressesbooleanSync addresses from Pax8
integrator_enabledbooleanHaloIntegrator sync enabled
integrator_last_syncstring (date-time)Last sync timestamp
integrator_last_sync_errorstringLast sync error message
client_mappingsarrayClient mapping list (ExternalLink_List)
codestringOAuth authorization code
code_verifierstringOAuth PKCE code verifier
default_item_groupintegerDefault item group ID
default_item_group_namestringDefault item group name
import_productsintegerProduct import setting
deactivate_missing_licensesbooleanDeactivate licenses not found in Pax8
_warningstringWarning message

GET /Pax8Details/{id}

Get a single Pax8 integration by ID.

ParameterTypeRequiredDescription
idintegerYes (path)Record ID

DELETE /Pax8Details/{id}

Delete a Pax8 integration configuration.

ParameterTypeRequiredDescription
idintegerYes (path)Record ID

IngramMicroDetails

Manage Ingram Micro distribution integration credentials and configuration.

GET /IngramMicroDetails

List all Ingram Micro integration configurations. Requires authentication.

POST /IngramMicroDetails

Create or update Ingram Micro integration configurations.

Request body: Array of IngramMicroDetails

IngramMicroDetails schema:

PropertyTypeDescription
idintegerRecord ID
namestringIntegration name
new_methodbooleanUse new auth method
import_entitiesstringComma-separated entity types to import
toplevelintegerTop-level client ID
update_addressesbooleanSync addresses
marketplacestringMarketplace identifier
usernamestringAPI username
guidstring (uuid)Integration GUID
new_passwordstringAPI password (write-only)
new_subscription_keystringSubscription key (write-only)
new_access_tokenstringAccess token (write-only)
client_mappingsarrayClient mapping list (ExternalLink_List)
top_level_namestringTop-level client name
halointegratorbooleanHaloIntegrator sync enabled
halointegrator_lastsyncstring (date-time)Last sync timestamp
halointegrator_lasterrorstringLast sync error message
deactivate_missing_licensesbooleanDeactivate missing licenses
import_entities_listarrayEntity import list (KeyPair2 objects)
_warningstringWarning message

GET /IngramMicroDetails/{id}

Get a single Ingram Micro integration. Returns a single instance of IngramMicroDetails. Requires authentication.

ParameterTypeRequiredDescription
idintegerYes (path)Record ID
includedetailsbooleanNo (query)Include additional detail objects

DELETE /IngramMicroDetails/{id}

Delete an Ingram Micro integration configuration.

ParameterTypeRequiredDescription
idintegerYes (path)Record ID

IngramMicroReseller

Read-only endpoints for Ingram Micro reseller data retrieval.

GET /IngramMicroReseller/Get

Retrieve Ingram Micro reseller information.

GET /IngramMicroReseller/GetQuote

Retrieve a quote from Ingram Micro.


IngramMicroResellerDetails

Manage Ingram Micro reseller integration configuration with full order status mapping and webhook support.

GET /IngramMicroResellerDetails

List all Ingram Micro reseller configurations.

POST /IngramMicroResellerDetails

Create or update Ingram Micro reseller configurations.

Request body: Array of IngramMicroResellerDetails

IngramMicroResellerDetails schema:

PropertyTypeDescription
idintegerRecord ID
namestringIntegration name
new_methodbooleanUse new auth method
client_idstringOAuth client ID
customer_numberstringIngram customer number
country_codestringCountry code
correlation_idstringCorrelation ID for API requests
company_idintegerCompany ID
receive_order_status_updatedbooleanReceive order status update webhooks
receive_quote_to_orderbooleanReceive quote-to-order webhooks
auto_create_purchase_orderbooleanAuto-create purchase orders
sync_entitiesstringEntities to sync
sync_entities_listarraySync entity list (KeyPair2 objects)
api_app_typeintegerAPI application type
reseller_siteintegerReseller site ID
bill_to_address_idstringBill-to address ID
delivery_address_auto_pointegerDelivery address for auto PO
order_status_canceledintegerHaloPSA status for Canceled orders
order_status_backorderedintegerHaloPSA status for Backordered orders
order_status_invoicedintegerHaloPSA status for Invoiced orders
order_status_processingintegerHaloPSA status for Processing orders
order_status_holdintegerHaloPSA status for Hold orders
order_status_deliveredintegerHaloPSA status for Delivered orders
order_status_shippedintegerHaloPSA status for Shipped orders
order_status_orderedintegerHaloPSA status for Ordered orders
new_client_secretstringClient secret (write-only)
new_access_tokenstringAccess token (write-only)
new_webhook_signaturestringWebhook signature key (write-only)
guidstring (uuid)Integration GUID
default_assetgroup_idintegerDefault asset group ID
default_assetgroup_namestringDefault asset group name
_warningstringWarning message

GET /IngramMicroResellerDetails/{id}

Get a single Ingram Micro reseller configuration by ID.

ParameterTypeRequiredDescription
idintegerYes (path)Record ID

DELETE /IngramMicroResellerDetails/{id}

Delete an Ingram Micro reseller configuration.

ParameterTypeRequiredDescription
idintegerYes (path)Record ID

SynnexDetails

Manage TD Synnex distribution integration credentials and configuration.

GET /SynnexDetails

List all Synnex integration configurations.

POST /SynnexDetails

Create or update Synnex integration configurations.

Request body: Array of SynnexDetails

SynnexDetails schema:

PropertyTypeDescription
idintegerRecord ID
namestringIntegration name
new_methodbooleanUse new auth method
client_idstringOAuth client ID
new_client_secretstringClient secret (write-only)
new_access_tokenstringAccess token (write-only)
guidstring (uuid)Integration GUID
client_mappingsarrayClient mapping list (ExternalLink_List)
import_entitiesstringComma-separated entity types to import
toplevelintegerTop-level client ID
top_level_namestringTop-level client name
update_addressesbooleanSync addresses
application_regionintegerAPI application region
application_typeintegerAPI application type
halointegratorbooleanHaloIntegrator sync enabled
halointegrator_lastsyncstring (date-time)Last sync timestamp
halointegrator_lasterrorstringLast sync error message
import_entities_listarrayEntity import list (KeyPair2 objects)
_warningstringWarning message

GET /SynnexDetails/{id}

Get a single Synnex integration. Requires authentication.

ParameterTypeRequiredDescription
idintegerYes (path)Record ID
includedetailsbooleanNo (query)Include additional detail objects

DELETE /SynnexDetails/{id}

Delete a Synnex integration configuration.

ParameterTypeRequiredDescription
idintegerYes (path)Record ID

ArrowSphereDetails

Manage Arrow Sphere cloud marketplace integration.

GET /ArrowSphereDetails

List all Arrow Sphere integration configurations.

POST /ArrowSphereDetails

Create or update Arrow Sphere integration configurations.

Request body: Array of ArrowSphereDetails

ArrowSphereDetails schema:

PropertyTypeDescription
idintegerRecord ID
namestringIntegration name
urlstringArrow Sphere API URL
new_api_keystringAPI key (write-only)
top_levelintegerTop-level client ID
top_level_namestringTop-level client name
update_addressesbooleanSync addresses
guidstring (uuid)Integration GUID
import_entitiesstringComma-separated entity types to import
import_entities_listarrayEntity import list (KeyPair2 objects)
halo_integratorbooleanHaloIntegrator sync enabled
halo_integrator_last_syncstring (date-time)Last sync timestamp
halo_integrator_errorstringLast sync error message
client_mappingsarrayClient mapping list (ExternalLink_List)
_warningstringWarning message

GET /ArrowSphereDetails/{id}

Get a single Arrow Sphere integration by ID.

ParameterTypeRequiredDescription
idintegerYes (path)Record ID

DELETE /ArrowSphereDetails/{id}

Delete an Arrow Sphere integration configuration.

ParameterTypeRequiredDescription
idintegerYes (path)Record ID

StreamOneIonDetails

Manage TD Synnex StreamOne Ion cloud marketplace integration.

GET /StreamOneIonDetails

List all StreamOne Ion integration configurations.

POST /StreamOneIonDetails

Create or update StreamOne Ion integration configurations.

Request body: Array of StreamOneIonDetails

StreamOneIonDetails schema:

PropertyTypeDescription
idintegerRecord ID
namestringIntegration name
account_idstringStreamOne account ID
new_methodbooleanUse new auth method
guidstring (uuid)Integration GUID
import_entitiesstringComma-separated entity types to import
top_levelintegerTop-level client ID
update_addressesbooleanSync addresses
halointegratorbooleanHaloIntegrator sync enabled
halointegrator_lastsyncstring (date-time)Last sync timestamp
halointegrator_lasterrorstringLast sync error message
new_refresh_tokenstringRefresh token (write-only)
new_access_tokenstringAccess token (write-only)
client_mappingsarrayClient mapping list (ExternalLink_List)
top_level_namestringTop-level client name
import_entities_listarrayEntity import list (KeyPair2 objects)
_warningstringWarning message

GET /StreamOneIonDetails/{id}

Get a single StreamOne Ion integration by ID.

ParameterTypeRequiredDescription
idintegerYes (path)Record ID

DELETE /StreamOneIonDetails/{id}

Delete a StreamOne Ion integration configuration.

ParameterTypeRequiredDescription
idintegerYes (path)Record ID

TechDataResellerDetails

Manage TD Synnex (Tech Data) reseller integration.

GET /TechDataResellerDetails

List all Tech Data reseller configurations.

POST /TechDataResellerDetails

Create or update Tech Data reseller configurations.

Request body: Array of TechDataResellerDetails

TechDataResellerDetails schema:

PropertyTypeDescription
idintegerRecord ID
namestringIntegration name
new_methodbooleanUse new auth method
client_idstringOAuth client ID
typeintegerIntegration type
regionstringAPI region
api_to_useintegerWhich API version to use
customer_numberstringTech Data customer number
application_typeintegerApplication type
new_client_secretstringClient secret (write-only)
guidstring (uuid)Integration GUID
_warningstringWarning message

GET /TechDataResellerDetails/{id}

Get a single Tech Data reseller configuration by ID.

ParameterTypeRequiredDescription
idintegerYes (path)Record ID

DELETE /TechDataResellerDetails/{id}

Delete a Tech Data reseller configuration.

ParameterTypeRequiredDescription
idintegerYes (path)Record ID

DattoCommerceDetails

Manage Datto Commerce integration for quote and purchase order workflows.

GET /DattoCommerceDetails

List all Datto Commerce integration configurations. Requires authentication.

ParameterTypeRequiredDescription
includedetailsbooleanNo (query)Include additional detail objects

POST /DattoCommerceDetails

Create or update Datto Commerce integration configurations.

Request body: Array of DattoCommerceDetails

DattoCommerceDetails schema:

PropertyTypeDescription
idintegerRecord ID
urlstringDatto Commerce API URL
new_api_keystringAPI key (write-only)
halointegratorenabledbooleanHaloIntegrator sync enabled
halointegrator_lastsyncstring (date-time)Last sync timestamp
halointegrator_lasterrorstringLast sync error message
item_groupintegerDefault item group ID
item_group_namestringDefault item group name
customer_field_mappingsarrayCustomer field mappings (IntegrationFieldMapping)
item_group_mappingsarrayItem group mappings (ExternalLink_List)
quote_status_mappingsarrayQuote status mappings (IntegrationFieldMapping)
create_items_on_importbooleanAuto-create items on import
product_supplier_on_importbooleanSet product supplier on import
sostatustoimportstringSales order status filter for import
sostatustoimport_listarrayAvailable SO status options (KeyPair2)
halo_integrator_import_liststringImport list configuration
halo_integrator_import_typesarrayImport type options (KeyPair2)
_warningstringWarning message