How to create an HaloPSA API User

How to create an HaloPSA API User

Connect your HaloPSA Instance to Propel Your MSP

To connect your HaloPSA instance to Propel Your MSP, you will need the following information:
  1. Your instance's domain name (typically something like yourcompany.halopsa.com)
  2. The API's Client ID and Client Secret (see below)
Idea
It's a best practice to specify only the minimum security rights required by any third party provider

1- Creating an API-only Agent

  1. Login to your HaloPSA account
  2. Navigate to  Configuration>Teams & Agents>Agents and click "New"
  3. Fill in the following information:
    1. Username = Propel Your MSP
    2. Active = checked
    3. Is an API-only Agent = checked
    4. First Name = Propel
    5. Last Name = Your MSP
    6. Initials = PYM
    7. Can approve Purchase Orders = unchecked
    8. Can approve Invoices = unchecked
  4. Go to "Permissions" tab and set the permissions as shown below:
    1. Feature Access
      1. Tickets Access Level: Read and Modify
      2. Customers Access Level: Read Only
      3. Assets Access Level: Read and Modify
      4. Calendars and Appointments Access Level
      5. Sales Access Level: Read and Modify
      6. Invoices Access Level: Read Only
      7. Customer Agreements Access Level: Read Only
    2. Tickets Permissions
      1. Can add new Tickets: Yes
      2. Can view Unassigned Tickets: Yes
      3. Can view Tickets that are assigned to other Agents: Yes
    3. Asset Type Restrictions
      1. Allow use of all Asset Types: Yes
    4. Calendars and Appointments Permissions
      1. Adding New Appointments: Can Add All Appointments
      2. Visibility of Appointments: Can View All Appointments

2- Creating Your API Key

You need to generate HaloPSA API keys so that Propel Your MSP can sync data with your PSA.
Warning
Be sure to make a copy of both the Client ID and Client Secret because the Client Secret will only be displayed once.
  1. Login to your HaloPSA account
  2. Navigate to  Configuration > Integrations > HaloPSA API > Applications and click "New"
  3. Fill in the following information:
    1. Application Name = Propel Your MSP
    2. Active = checked
    3. Authentication Method = Client ID and Secret (Services)
  4. Copy the Client ID and Client Secret in a secure location
  5. Login Type = Agent
  6. Agent to log in as = "Propel Your MSP"
  7. Go to "Permissions" tab and set the permissions as shown below
    1. all:teams
    2. edit:tickets
    3. edit:calendar
    4. read:customers
    5. read:contracts
    6. read:items
    7. edit:sales
    8. read:invoices
    9. read:assets
    10. edit:assets
  8. Save your changes


    • Related Articles

    • How to create an Autotask API User?

      Connect your Autotask PSA Instance to Propel Your MSP To connect your Autotask PSA instance to Propel Your MSP, you will need the following setup: Setup a security role for the "Propel Your MSP" user Create an API User (Key & Secret) Security Role We ...

    • How to create a ConnectWise Manage API Member Key?

      Connect your ConnectWise Manage Instance to Propel Your MSP To connect your ConnectWise Manage instance to Propel Your MSP, you will need the following information: Your instance's domain name (typically connect.yourcompany.com) The Company ID ...

    • Changelog - Release notes

      Propel Your MSP is updated frequently. When updates are deployed, a new entry is added to this changelog here. You can subscribe to the RSS feed to receive using your preferred RSS reader to receive notifications: ...

    • ConnectWise Manage Integration error "You do not have security permission to perform this action."

      Are you are seeing this error about your ConnectWise Manage integration when signing in to Propel Your MSP? The reason is because in ConnectWise Manage v2020.4, a new "Table Setup" security permission, introduced in v2020.3 has started throwing the ...

    • FAQ - Asset Mapping - Autotask PSA specifics

      If you have not yet read PSA to Propel Your MSP Asset Mapping, please do so now Autotask PSA Considerations Autotask PSA has both a Configuration Item Category and a Configuration Item Type. Propel uses the Configuration Item Type when configuring ...