Getting Your Credentials

In order to create a new Viewabo Case, you’ll need your API Access Token, your Account Uniq ID, and the email of the user accessing the API.

<aside> <img src="/icons/photo-landscape_gray.svg" alt="/icons/photo-landscape_gray.svg" width="40px" /> You can find the API Access Token on the Settings > Company page

</aside>

The Account Uniq ID is located in the URL path after the /a. In the above example, the Account Uniq ID would be 844347765.

You may use an existing Viewabo User email or a new email. If the email used does not currently belong to an existing Viewabo User, a new Viewabo User will be created as a guest user (guest users can access Viewabo recordings, but can not initiate new STREAMs or CAPTUREs).

Create A New Viewabo Case

To create a case, send a POST request to https://api.viewabo.com/cases (https://api.staging.viewabo.com/cases on staging) with your Account Uniq ID and email. Optionally, you may also send a subject and a unique identifier from your CRM as the external_id.

<aside> <img src="/icons/photo-landscape_gray.svg" alt="/icons/photo-landscape_gray.svg" width="40px" /> Send a POST request to https://api.viewabo.com/cases

</aside>

You’ll need to set the Authorization Header with your API Access Token. The API Access Token must be prepended with either Bearer or Token.

<aside> <img src="/icons/photo-landscape_gray.svg" alt="/icons/photo-landscape_gray.svg" width="40px" /> Set the Authorization Header with your API Access Token

</aside>

You should expect a response with the Case Uniq ID and the canonical URL, which you may save to your CRM.

<aside> <img src="/icons/photo-landscape_gray.svg" alt="/icons/photo-landscape_gray.svg" width="40px" /> Response

</aside>

The URL will forward you to the Viewabo Case page where you may start multiple STREAMs and CAPTUREs associated with the same issue. You can also see any previously created STREAMs and CAPTUREs as well.

<aside> <img src="/icons/photo-landscape_gray.svg" alt="/icons/photo-landscape_gray.svg" width="40px" /> Viewabo Case page

</aside>

Adding STREAMs/CAPTUREs to a Viewabo Case

By default, you’ll need to be authenticated to view a Viewabo Case. Any type of user may create and view Viewabo Cases.

Per your company’s security policies, we can also allow the canonical link to redirect to a shareable Viewabo Case page. Please contact your representative in order to set up this flow.

You’ll need to be a licensed user in order to add new STREAMs and CAPTUREs to a Viewabo Case. You can manage user access under Settings > Users in the Viewabo dashboard.

<aside> <img src="/icons/photo-landscape_gray.svg" alt="/icons/photo-landscape_gray.svg" width="40px" /> Manage user access under Settings > Users

</aside>

You may switch which users have licenses to create new STREAMs and CAPTUREs by toggling Access on or off.

The number of licenses you have will be listed in the same page. This will vary from company to company.