API

An an admin you can create and manage your Next Matter API keys and use Next Matter API to integrate with third-party systems.

Create an API key

πŸ“˜

If you have API keys that were generated for you by our Support team, they will show up on the list of active keys.

You can only create and manage keys if you're a Next Matter admin.

  1. Go to Company > Next Matter API keys.
  2. In the top-right corner, click + Create API key.
  3. Enter the name for the key and select the user that to whom the key will be assigned.
  4. (Optional) To set the expiry date for the key, select the Add expiry date checkbox and select the date and time. If the expiry date hasn't been set, the key will not have a default expiry date.

πŸ“˜

The date and time are displayed in the timezone of the browser.

  1. Click Create API key.
  2. Copy the key and click Done.

πŸ“˜

You can always update the expiry date for the key even if the key has already expired. Click Edit for the key and enter a new date.

Update a key

You can re-assign the key to another user or update the expiry date. To update the key, click the pencil icon and edit the data.

A screenshot of the Next Matter API key. The pencil icon to edit the key is visible to the right of the key data.

Delete or revoke key

To delete or revoke a key click the ... (three dots) to the right of the key data and select the action. Before you delete or revoke, ensure there is no integration using this key. Otherwise, the integration step will fail.

Once you revoke or delete the key, you can't activate it again.

A screenshot of the Next Matter API key. The action icon on the right is expanded showing the Delete API key and Revoke API key as possible actions.

Use Next Matter API

You will find the list of parameters for the Next Matter API calls here.

However, you can also browse code examples for specific use cases such as:

  • How to complete a decision step using API
  • How to upload a file
  • Update an email-step or user-selection drop-down
  • How to stop an instance
  • How to select and delete instances