{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"BMC Helix ITSM Ticketing Provider Configuration Guide","siteUrl":"https://docs.synqly.com","lang":"en-US","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"introduction","__idx":0},"children":["Introduction"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["BMC Helix ITSM is an IT service management platform used to track and resolve incidents. This guide walks you through the steps to gather the necessary information and configure your BMC Helix ITSM environment for the purpose of creating a BMC Helix ITSM Ticketing integration."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prerequisites","__idx":1},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before you begin, ensure that you have:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Access to a BMC Helix ITSM instance with the AR REST API enabled"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Access to a BMC Helix ITSM account that has permission to create users and manage their permission groups"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"required-permissions","__idx":2},"children":["Required Permissions"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Permission Group"},"children":["Permission Group"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Purpose"},"children":["Purpose"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Incident User"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Query, create, and update incidents, and read and add the work log entries behind their notes, comments, and attachments. Incident User works on incidents that are assigned to or owned by a support group the account belongs to, so add the service account to the support groups whose incidents the integration should manage."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Incident User is the least access that supports most of the integration. Two things it does not cover:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Incidents outside the service account's support groups."]}," They are neither readable nor updatable, so add every support group whose incidents the integration should manage."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Deleting or editing a work log entry created by someone else."]}," Incident User can only change its own entries, so deleting a note or comment that a person wrote in BMC Helix will fail."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Grant ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Incident Master"]}," instead if you need either of those. It works on every incident in the account regardless of support group, and can change any work log entry that is not locked."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"generating-credentials","__idx":3},"children":["Generating Credentials"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Log in to your BMC Helix ITSM instance using an account with administrator permissions",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The steps below follow the classic web interface, which BMC's documentation calls ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Mid Tier"]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Applications > Administrator Console > Application Administration Console"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Application Settings"]}," list, select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Foundation > People > People"]}," and click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Open"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create the person record for a dedicated service account, or open the existing one. Use a service account rather than a personal account, so the integration keeps working when people leave"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["On the ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["People"]}," form, click the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Application Permission"]}," tab"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Update Permission Groups"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Permission Group"]}," dialog box, select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Incident User"]}," from the ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Permission Group"]}," list, then save the person record. The permission groups are described in the section above titled ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#required-permissions"},"children":["Required Permissions"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Take note of the service account's login name and password, and store these values in a safe location"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You have now created a service account for the integration. Proceed to the next section titled ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#configuring-the-integration"},"children":["Configuring the Integration"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For more information on BMC Helix permission groups, see the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.bmc.com/docs/itsm233/roles-and-permissions-1235117369.html"},"children":["BMC Helix ITSM Roles and permissions"]}," docs page."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"configuring-the-integration","__idx":4},"children":["Configuring the Integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To configure a new BMC Helix ITSM integration in the Synqly system, provide each of the values as defined below:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Integration Parameter"},"children":["Integration Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Base URL"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["This is the root URL of your BMC Helix ITSM instance, for example ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://your-instance.bmc.com"]},". Do not include any path components such as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Username"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["This is the username of the BMC Helix ITSM service account gathered when creating the service account above."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Password"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["This is the password of the BMC Helix ITSM service account gathered when creating the service account above."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Skip TLS Verification"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional. Enable this when connecting to a BMC Helix ITSM instance that uses a self-signed certificate. Defaults to disabled, and should only be enabled for development or testing environments."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"additional-resources","__idx":5},"children":["Additional Resources"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.bmc.com/docs/itsm233/roles-and-permissions-1235117369.html"},"children":["BMC Helix ITSM Roles and permissions"]}," docs page"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.bmc.com/docs/itsm233/incident-management-user-roles-and-permissions-1235117373.html"},"children":["BMC Helix ITSM Incident management user roles and permissions"]}," docs page"]}]}]},"headings":[{"value":"Introduction","id":"introduction","depth":2},{"value":"Prerequisites","id":"prerequisites","depth":2},{"value":"Required Permissions","id":"required-permissions","depth":2},{"value":"Generating Credentials","id":"generating-credentials","depth":2},{"value":"Configuring the Integration","id":"configuring-the-integration","depth":2},{"value":"Additional Resources","id":"additional-resources","depth":2}],"frontmatter":{"slug":"guides/provider-configuration/bmchelix-ticketing-setup","seo":{"title":"BMC Helix ITSM Ticketing Provider Configuration Guide"}},"lastModified":"2026-09-08T14:42:47.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/provider-configuration/bmchelix-ticketing-setup","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}