Help & Support

The Spearline API

Let our API take the headache out of managing multiple systems, allowing you to view and manage Spearline tests and reports from your existing number management system.

The Spearline API is a RESTful API, designed to be a flexible tool that you can configure to fit your existing systems and processes. You will have the ability to pick and choose the features you wish to implement.

Benefits of the Spearline API:

  • Automate the process of adding, editing and deleting numbers. This improves the efficiency of your team and allows them to use one single platform rather than requiring training on multiple interfaces.
  • Personalize your experience and enable only the functionality that is appropriate to your business.
  • Tie test schedules to call reports to ensure your busiest numbers are being tested at frequencies appropriate to their importance.
  • Streamline your systems and make changes from the comfort of your own number management system.

What is ITSM?

You may have already invested in ITSM tools to help your team monitor and manage critical services. ITSM (IT Service Management) are essentially the activities that are performed by an organization to design, build, deliver, operate and control IT services offered to customers.

Spearline can integrate with your existing ITSM systems that accept emails, SNMP, and Webhook (HTTP post) or utilize API, to allow individuals to view, and respond to  issues, without having to log in to the Spearline platform.

Benefits of ITSM integration:

  • Reduce MTRS and MTTR, and resolve problems quickly.

    As alerts automatically create tickets on your ITSM platform, eliminating the requirement for human intervention to open an email alert, analyse the alert and make the decision to open ITSM Incident ticket, it reduces the meantime to restore service (MTRS) and mean time to recovery (MTTR).

  • Minimize unwanted change

    ITSM integration means minimizing unwanted changes, and allows you to focus on what is important in your organization.

  • Direct alerts to the correct individual

    For organizations that rely on systems to route alerts to employees on-call, integrating Spearline alerts with your ITSM will ensure that they are assigned to the correct individual. 

  • Receive alerts in realtime, as soon as an issue occurs

    As alerts are sent directly to individuals in your key resolver teams in realtime, it ensures that no important information is missed and the issue can be acted upon straight away.


  • More control with centralization

    ITSM Integration allows for centralization, and lessens the cognitive load on your employees, reducing any human error which may occur.

How does ITSM work with the Spearline platform?

Spearline’s ability to monitor your communication infrastructure means that we can trigger an alert on your ITSM based on the current performance or health of your service. You can then use your ITSM to track these issues using the procedures and tools you are familiar with.

The exact criteria as to when to trigger these alerts can be decided in collaboration with your Spearline Customer Engagement Manager. 


Once the criteria are decided, we can trigger an alert on your ITSM in the following ways:

  • Email – an email is sent to an address of your choosing.
  • Webhook – HTTP post is sent to the URI endpoint of your choosing.
  • SNMP – An SNMP trap is sent to your SNMP service.
  • API Integration – If your ITSM has an API available, then Spearline’s engineers can write a bespoke API client for you.


The contents of the alerts we issue include extensive details of what issue occurred and when. The exact contents and formatting of the alerts can be tailored to your needs.


How to set up ITSM with Spearline? 

If you are interested in integrating your ITSM with Spearline’s platform, please get in contact with your Customer Engagement Manager who will be happy to go through the necessary steps with you. Alternatively, please email or call + 353 28 51460. 

Single sign-on

What is Single sign-on?

Single sign-on (SSO) is an authentication feature that allows an individual to log in with a single ID and password to any of several related, yet independent, software systems.

True SSO allows an individual to log in once, and access services without re-entering authentication factors. 

Benefits of single sign-on:

  • Greater password management control.

    With SSO, passwords are stored and managed by our customers, not Spearline.  This means organizations no longer need to rely on Spearline to securely handle their passwords.

    Password fatigue is greatly reduced from having to remember and enter multiple different user name and password combinations. Additionally, individuals are no longer slowed down by multiple logins, or required to remember multiple passwords to access network resources.

  • Mitigate security risks through centralized authorization.

    Eliminating multiple passwords reduces a common source of security breaches – individuals writing down their password being the main one.

    As a result of the consolidation of network management information, the administrator can know for certain that when a user’s account is disabled, the account is fully disabled.

  • Reduce IT costs and resources.

    As individuals are not required to remember several passwords, it means fewer requests to IT helpdesk personnel about forgotten passwords.

  • Improve administrative control.

    As all network management information is stored in a single repository,  there is a single, authoritative listing of each user’s access rights and privileges. This allows the IT administrator to change an individual’s privileges once, and know that the results will permeate network-wide.

  • Consolidate independent networks.

    By joining disparate networks, administrative efforts can be consolidated, ensuring that administrative best practices and corporate security policies are being consistently enforced.

  • Improve time management.

    Time spent entering different passwords for the same identity is significantly minimized. 

How does single sign-on work with the Spearline platform?

Single sign-on allows you to include the Spearline platform in your centralized authentication server.  Spearline integrates with a SAML identity provider to allow individuals to log in once, and access the Spearline platform, without having to re-enter authentication factors.

SAML is an enterprise B2B SSO protocol.  A SAML IdP (or identity provider) is the part that provides the login information, which in this case is managed by the customer. A SAML SP (or service provider) is the part that offers the service which in this case, is the Spearline platform. 

The Spearline SSO process works as follows:

  • An individual opens up

  • They then get redirected to their own login page, that is managed and hosted by the organization they work for.

  • If they login with the correct credentials, they get redirected to the Spearline platform, with a token from the login page authenticating them to the Spearline platform.

  • The Spearline platform validates the token, and then grants the individual access.

  • Once the customer has verified that SSO logins are working correctly, Spearline disables non-SSO logins for them, and removes their passwords from the database.

How to sign up for single sign-on with Spearline? 

If you are interested in SSO to access the Spearline platform, please get in contact with your Customer Engagement Manager who will be happy to go through the necessary steps with you. Alternatively, please email or call + 353 28 51460. 

Not Ready Yet?

Subscribe for updates