Vision 6

Getting Started

The Vision6 REST API supports transactional methods that can be used to trigger time-sensitive and critical communications.
Examples are welcome packs, invoices (as attachments), statements, payment confirmations and password resets.

Getting Started

Top ↑

Requirements for accessing the JSON-RPC API

  • A Vision6 Account
  • A valid API Key.
  • A Standards Compliant JSON-RPC library (Find a library on github)
  • Network access over port 443 for SSL.
  • A user with the Access Level of Full access

Please contact your System Administrator if you are unsure as to whether you conform to these requirements.

The API endpoint can be found at:

The Vision 6 Integrations

Steps for Getting Started

  1. Get Access to a live Account

    You may need to contact the owner of a live Vision6 account that you are planning on developing for. They can then provide you with a Username and Password to access this account by setting you up with a user account.

    Once this has been completed, you can then login and obtain relevant API Key information.

  2. Need to get an account?

    Sign up for a free Vision6 account here. This free account will have full access to the API where you can test and build a live integration

  3. Confirm that your system has the API package and network access over port 443 for SSL.

  4. Download a JSON-RPC library.

    The API can use any JSON-RPC library. (Find a library on github)

    The example code in this document appears in both PHP and JSON-RPC. You may want to browse through some of the many implementations available online for download before selecting one.

  5. Download the available examples

    Download Examples

  6. Generate an API Key so you can access the API.

    To generate an API Key:

    1. Log in to the system.
      The initial screen is the Dashboard.
    2. Click the Integrations link on the Main Menu of the system, which is located on the left hand side of the page.
    3. At the top of the page, click the API Keys tab.
      The screen displays the API Keys page. You can create multiple API Keys on the API Keys page and give a different API Key to each API User.

    4. Click on the "Create a new API Key" button.
      Create a new API Key
      The Create API Key form will open.

      Add an API Key Dialogue Box

    5. Enter a name for the API Key.
      The name is for display purposes only. We recommend naming the key after its function, and, if it is being generated for a specific person, including the person's name in the key name.
    6. Once submitted a dialog will show your new API Key. This is a one time key only. Make sure you save this key in a secure location.

      Dialogue showing generated key

    7. After you copy and save the API Key, click Close.
      The new API Key is now listed on the API Keys page.

      Page with API Key

      When calling API methods, supply the API Key as the first parameter.

Next Steps

  1. Review and try out the Common Use Cases. If the use cases would add functionality to your system, adapt them so you can use them regularly.

  2. Review the Basic Structure of the JSON-RPC API

  3. Learn about Optimising API Performance

  4. Continue to the Method Reference Guide

See Also