Skip to main content

Creating API credentials

An API credential (a Client ID and Client Secret) lets StackOne request short-lived access tokens for your Eka workspace.

1

Sign in to Eka Console

Sign in to your Eka Console account.

  • Choose the sign-in method you use, such as Continue with Email.
The Login to Eka Care page with the sign-in options highlighted
2

Open API credentials

On the Dashboard, under Quick Actions, click Manage API Credentials ( Client IDs and Secrets ).

The Eka Console dashboard with Manage API Credentials highlighted under Quick Actions
3

Start a new credential

On the API Credentials page, click Create.

The API Credentials page with the Create button highlighted
4

Name the credential

In Create Client ID and Client Secret, enter a Name and click Create.

  • Name: any name you prefer, for example StackOne Integration
The Create Client ID and Client Secret form with the Name field and Create button highlighted
5

Copy the Client Secret

In Client Secret Created, click Copy to Clipboard and paste the value into the Client Secret field in StackOne Hub.

  • The Client Secret is only displayed once and cannot be retrieved later. Store it securely for use later.
  • Click Done.
The Client Secret Created dialog with the secret hidden and Copy to Clipboard highlighted
6

Copy the Client ID

Back on API Credentials, copy the Client ID of your new credential and paste it into the Client ID field in StackOne Hub.

  • Format: EC_ followed by digits
  • Example: EC_178843954824934
The API Credentials list with the Client ID of the new credential highlighted

Generating a Sharing Key (optional)

A Sharing Key lets the connection act on another clinic’s Eka workspace. Only add one when that workspace’s owner has generated it for you; leave the field empty to use your own workspace.

1

Sign in to Eka Hub

The workspace owner signs in to their Eka Hub account.

  • In the sidebar, open Utilities and click API Token.
The Eka Hub sidebar with Utilities and API Token highlighted
2

Create a new token

On the API Token page, click Create New.

The API Token page with the Create New button highlighted
3

Name the token

In Create APIToken, fill in Name: and Description:, then click Save.

  • Name: any name you prefer, for example StackOne Integration
  • Description: any short description, for example Integration with StackOne
The Create APIToken form with the Name, Description and Save controls highlighted
4

Copy the token

Copy the value in the Token column of the new row and paste it into the Sharing Key field in StackOne Hub.

  • Treat the token as a secret and store it securely for use later.
The API Token list with the new token value hidden and its Token cell highlighted

Find your MedAssist agent ID (optional)

The MedAssist Agent ID identifies your MedAssist agent. Only the MedAssist actions use it; leave it empty otherwise.

1

Open your agent

In the Eka Console sidebar, click Agents, then click your agent in the list.

The Agents page with the Agents menu item and an agent row highlighted
2

Copy the agent ID

Copy the ID shown under the agent name and paste it into the MedAssist Agent ID field in StackOne Hub.

  • Format: a Base64 string that ends in =
An agent page with the agent ID under the agent name highlighted

Linking the Account from the Hub

1

Navigate to the Hub

Use one of the three Linking Account Methods to access the Hub.
2

Fill out the fields

Fill out the following fields using details from your provider:
  • Client ID
  • Client Secret
  • Sharing Key (Optional)
  • MedAssist Agent ID (Optional)
3

Connect

  • Click Connect
  • If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider’s authorization flow.
  • Once authorization is successful, you will see a confirmation popup

If the account linking is successful, you will see the newly linked account on your Accounts page.

Next Steps

Webhooks setup

Configure receiving Events for Eka Care into StackOne.