Skip to main content

Social Media & CRM Endpoints

Social Media, CRM & Notifications

FacebookDetails

Manage Facebook integration configurations for creating tickets from Messenger messages, posts, ratings, and ads.

GET /FacebookDetails

Summary: List of FacebookDetails

Returns multiple FacebookDetails. Requires authentication.

ParameterTypeDescription
page_idstringFilter by Facebook page ID

POST /FacebookDetails

Create or update FacebookDetails.

Request Body: Array of FacebookDetails

Key fields:

FieldTypeDescription
idintegerRecord ID
user_idstringFacebook user ID
page_idstringFacebook page ID
page_namestringFacebook page name
authorizedbooleanWhether the connection is authorized
create_messenger_ticketsbooleanAuto-create tickets from Messenger messages
messenger_ticket_typeintegerTicket type ID for Messenger tickets
messenger_userintegerDefault user ID for Messenger tickets
reopen_messenger_ticketsbooleanReopen existing tickets on new messages
create_post_ticketsbooleanAuto-create tickets from page posts
post_ticket_typeintegerTicket type ID for post tickets
post_userintegerDefault user ID for post tickets
days_after_postintegerDays after post to stop monitoring
include_word_listarrayKeywords that trigger ticket creation
exclude_word_listarrayKeywords that exclude ticket creation
ratings_create_ticketsbooleanAuto-create tickets from ratings
ratings_ticket_typeintegerTicket type ID for rating tickets
ratings_only_negativebooleanOnly create tickets for negative ratings
ads_create_ticketsbooleanAuto-create tickets from ads
linked_instagram_accountstringLinked Instagram account

GET /FacebookDetails/{id}

Summary: Get one FacebookDetails

Returns a single FacebookDetails instance. Requires authentication.

ParameterTypeDescription
idinteger (path, required)FacebookDetails ID
includedetailsbooleanInclude extra detail objects

DELETE /FacebookDetails/{id}

Delete a FacebookDetails record.

ParameterTypeDescription
idinteger (path, required)FacebookDetails ID

TwitterDetails

Manage Twitter/X integration configurations for creating tickets from direct messages and mentions.

GET /TwitterDetails

Summary: List of TwitterDetails

Returns multiple TwitterDetails. Requires authentication.

ParameterTypeDescription
account_idstringFilter by Twitter account ID

POST /TwitterDetails

Create or update TwitterDetails.

Request Body: Array of TwitterDetails

Key fields:

FieldTypeDescription
idintegerRecord ID
screen_namestringTwitter screen name
user_idstringTwitter user ID
authorizedbooleanWhether the connection is authorized
create_direct_message_ticketsbooleanAuto-create tickets from DMs
direct_message_ticket_typeintegerTicket type ID for DM tickets
direct_message_userintegerDefault user ID for DM tickets
reopen_direct_message_ticketsbooleanReopen existing tickets on new DMs
create_mention_ticketsbooleanAuto-create tickets from mentions
mention_ticket_typeintegerTicket type ID for mention tickets
mention_userintegerDefault user ID for mention tickets
days_after_mentionintegerDays after mention to stop monitoring
include_word_listarrayKeywords that trigger ticket creation
exclude_word_listarrayKeywords that exclude ticket creation
direct_message_create_usersbooleanAuto-create users from DM senders
mention_create_usersbooleanAuto-create users from mention authors

GET /TwitterDetails/{id}

Summary: Get one TwitterDetails

Returns a single TwitterDetails instance. Requires authentication.

ParameterTypeDescription
idinteger (path, required)TwitterDetails ID
includedetailsbooleanInclude extra detail objects

DELETE /TwitterDetails/{id}

Delete a TwitterDetails record.

ParameterTypeDescription
idinteger (path, required)TwitterDetails ID

GoogleBusinessDetails

Manage Google Business integration configurations.

GET /GoogleBusinessDetails

Returns a list of GoogleBusinessDetails.

POST /GoogleBusinessDetails

Create or update GoogleBusinessDetails.

Request Body: Array of GoogleBusinessDetails

Key fields:

FieldTypeDescription
idintegerRecord ID
connectionnamestringDisplay name for the connection
authorizedbooleanWhether the connection is authorized
enabledbooleanWhether the integration is enabled
accountstringGoogle Business account ID
locationstringGoogle Business location ID
account_namestringGoogle Business account name
location_namestringGoogle Business location name

GET /GoogleBusinessDetails/{id}

Returns a single GoogleBusinessDetails instance.

ParameterTypeDescription
idinteger (path, required)GoogleBusinessDetails ID

DELETE /GoogleBusinessDetails/{id}

Delete a GoogleBusinessDetails record.

ParameterTypeDescription
idinteger (path, required)GoogleBusinessDetails ID

WordpressDetails

Manage WordPress.com integration configurations (OAuth-based).

GET /WordpressDetails

Returns a list of WordpressDetails.

POST /WordpressDetails

Create or update WordpressDetails.

Request Body: Array of WordpressDetails

Key fields:

FieldTypeDescription
idintegerRecord ID
connectionnamestringDisplay name for the connection
authorizedbooleanWhether the connection is authorized
enabledbooleanWhether the integration is enabled
blogidstringWordPress blog ID
blogurlstringWordPress blog URL

GET /WordpressDetails/{id}

Returns a single WordpressDetails instance.

ParameterTypeDescription
idinteger (path, required)WordpressDetails ID

DELETE /WordpressDetails/{id}

Delete a WordpressDetails record.

ParameterTypeDescription
idinteger (path, required)WordpressDetails ID

WordpressOrgDetails

Manage WordPress.org (self-hosted) integration configurations.

GET /WordpressOrgDetails

Returns a list of WordpressOrgDetails.

POST /WordpressOrgDetails

Create or update WordpressOrgDetails.

Request Body: Array of WordpressOrgDetails

Key fields:

FieldTypeDescription
idintegerRecord ID
connectionnamestringDisplay name for the connection
usernamestringWordPress username
enabledbooleanWhether the integration is enabled
blogurlstringWordPress blog URL
import_this_tagintegerTag ID to import posts by
post_status_to_importstringPost status filter for import
use_custom_endpointbooleanUse a custom REST endpoint
custom_endpointstringCustom endpoint URL
default_faqlistintegerDefault FAQ list ID for imported articles
importcategoriesbooleanImport WordPress categories

GET /WordpressOrgDetails/{id}

Returns a single WordpressOrgDetails instance.

ParameterTypeDescription
idinteger (path, required)WordpressOrgDetails ID

DELETE /WordpressOrgDetails/{id}

Delete a WordpressOrgDetails record.

ParameterTypeDescription
idinteger (path, required)WordpressOrgDetails ID

ConfluenceDetails

Manage Atlassian Confluence integration configurations.

GET /ConfluenceDetails

Returns a list of ConfluenceDetails.

POST /ConfluenceDetails

Create or update ConfluenceDetails.

Request Body: Array of ConfluenceDetails

Key fields:

FieldTypeDescription
idintegerRecord ID
namestringConnection name
urlstringConfluence instance URL
usernamestringConfluence username
enabledbooleanWhether the integration is enabled
allow_webhooksbooleanAllow incoming webhooks
webhook_authenticationintegerWebhook authentication type
faq_linksarrayLinked FAQ list configurations

GET /ConfluenceDetails/{id}

Returns a single ConfluenceDetails instance.

ParameterTypeDescription
idinteger (path, required)ConfluenceDetails ID

DELETE /ConfluenceDetails/{id}

Delete a ConfluenceDetails record.

ParameterTypeDescription
idinteger (path, required)ConfluenceDetails ID

JiraDetails

Manage Atlassian Jira integration configurations.

GET /JiraDetails

Returns a list of JiraDetails.

POST /JiraDetails

Create or update JiraDetails.

Request Body: Array of JiraDetails

Key fields:

FieldTypeDescription
idintegerRecord ID
namestringConnection name
instance_urlstringJira instance URL
usernamestringJira username
defaulttickettypeintegerDefault HaloPSA ticket type for Jira issues
defaultuserintegerDefault user ID for imported Jira issues
issuetypestringJira issue type to sync
status_mappingsarrayStatus mapping between Jira and HaloPSA
priority_mappingsarrayPriority mapping between Jira and HaloPSA
jirafield_mappingsarrayCustom field mappings
allow_webhooksbooleanAllow incoming webhooks from Jira
visibletoendusersbooleanMake synced tickets visible to end users

GET /JiraDetails/{id}

Returns a single JiraDetails instance.

ParameterTypeDescription
idinteger (path, required)JiraDetails ID

DELETE /JiraDetails/{id}

Delete a JiraDetails record.

ParameterTypeDescription
idinteger (path, required)JiraDetails ID

AzureDevOps

Manage Azure DevOps integration configurations.

GET /AzureDevOpsDetails

Returns a list of AzureDevOpsDetails.

POST /AzureDevOpsDetails

Create or update AzureDevOpsDetails.

Request Body: Array of AzureDevOpsDetails

Key fields:

FieldTypeDescription
idintegerRecord ID
namestringConnection name
instance_urlstringAzure DevOps instance URL
enableintegratorbooleanEnable the integration
ticket_typeintegerDefault HaloPSA ticket type
ticket_userintegerDefault user ID for synced work items
sync_statusbooleanSync status between systems
sync_prioritybooleanSync priority between systems
sync_attachmentsbooleanSync attachments
sync_summarybooleanSync summary/title
sync_area_pathbooleanSync Azure DevOps area path
sync_iteration_pathbooleanSync Azure DevOps iteration path
status_mappingsarrayStatus mappings
priority_mappingsarrayPriority mappings
areapath_mappingsarrayArea path mappings
fields_to_sync_listarrayList of fields to synchronize
enablepipelinesbooleanEnable pipeline integration
lastsyncdatedatetimeDate/time of last successful sync
lastsyncerrorstringLast sync error message

GET /AzureDevOpsDetails/{id}

Summary: Get one AzureDevOpsDetails

Returns a single AzureDevOpsDetails instance. Requires authentication.

ParameterTypeDescription
idinteger (path, required)AzureDevOpsDetails ID
includedetailsbooleanInclude extra detail objects

DELETE /AzureDevOpsDetails/{id}

Delete an AzureDevOpsDetails record.

ParameterTypeDescription
idinteger (path, required)AzureDevOpsDetails ID

SharePoint

GET /SharePoint/Get

Returns SharePoint integration details.


Opps

CRM Opportunities — stored as a special domain of the Faults/Tickets data model. Opportunities are prospects or sales pipeline records.

GET /Opportunities

Summary: List of Faults (Opportunities)

Returns multiple Opportunities. Requires authentication.

Response Schema: Faults_View

FieldTypeDescription
page_nointegerCurrent page number
page_sizeintegerPage size
record_countintegerTotal record count
ticketsarrayArray of Faults/Opportunity records

Key query parameters:

ParameterTypeDescription
advanced_searchstringAdvanced search expression
agentstringArray of agent IDs (comma-separated)
agent_idintegerFilter by agent ID
client_idintegerFilter by client ID
client_idsstringArray of client IDs
status_idintegerFilter by status ID
statusstringArray of status IDs
requesttype_idintegerFilter by request type ID
requesttypestringArray of request type IDs
itil_requesttype_idintegerFilter by ITIL request type ID
prioritystringArray of priority IDs
category_1stringArray of category 1 IDs
category_2stringArray of category 2 IDs
category_3stringArray of category 3 IDs
category_4stringArray of category 4 IDs
searchstringFull-text search string
search_detailsstringSearch within ticket details
search_summarystringSearch within ticket summary
search_oppcompanynamestringSearch by opportunity company name
search_oppcontactnamestringSearch by opportunity contact name
search_oppemailaddressstringSearch by opportunity email address
open_onlybooleanReturn only open opportunities
closed_onlybooleanReturn only closed opportunities
countintegerNumber of records to return
page_nointegerPage number (for pagination)
page_sizeintegerPage size (max 100)
pageinatebooleanEnable pagination
orderstringPrimary sort field
orderdescbooleanSort descending on primary order