Create Link Token

curl --request POST \
  --url https://api.usecobalt.com/v1/link/token/create \
  --header 'Content-Type: application/json' \
  --header 'client_id: <api-key>' \
  --header 'client_secret: <api-key>' \
  --data '
{
  "user_id": "<string>",
  "org_id": "<string>"
}
'

import requests

url = "https://api.usecobalt.com/v1/link/token/create"

payload = {
    "user_id": "<string>",
    "org_id": "<string>"
}
headers = {
    "client_id": "<api-key>",
    "client_secret": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    client_id: '<api-key>',
    client_secret: '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({user_id: '<string>', org_id: '<string>'})
};

fetch('https://api.usecobalt.com/v1/link/token/create', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.usecobalt.com/v1/link/token/create",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'user_id' => '<string>',
    'org_id' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "client_id: <api-key>",
    "client_secret: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.usecobalt.com/v1/link/token/create"

	payload := strings.NewReader("{\n  \"user_id\": \"<string>\",\n  \"org_id\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("client_id", "<api-key>")
	req.Header.Add("client_secret", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.usecobalt.com/v1/link/token/create")
  .header("client_id", "<api-key>")
  .header("client_secret", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"user_id\": \"<string>\",\n  \"org_id\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.usecobalt.com/v1/link/token/create")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["client_id"] = '<api-key>'
request["client_secret"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"user_id\": \"<string>\",\n  \"org_id\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "token": "<string>"
}

POST

link

token

create

Create Link Token

curl --request POST \
  --url https://api.usecobalt.com/v1/link/token/create \
  --header 'Content-Type: application/json' \
  --header 'client_id: <api-key>' \
  --header 'client_secret: <api-key>' \
  --data '
{
  "user_id": "<string>",
  "org_id": "<string>"
}
'

import requests

url = "https://api.usecobalt.com/v1/link/token/create"

payload = {
    "user_id": "<string>",
    "org_id": "<string>"
}
headers = {
    "client_id": "<api-key>",
    "client_secret": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    client_id: '<api-key>',
    client_secret: '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({user_id: '<string>', org_id: '<string>'})
};

fetch('https://api.usecobalt.com/v1/link/token/create', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.usecobalt.com/v1/link/token/create",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'user_id' => '<string>',
    'org_id' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "client_id: <api-key>",
    "client_secret: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.usecobalt.com/v1/link/token/create"

	payload := strings.NewReader("{\n  \"user_id\": \"<string>\",\n  \"org_id\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("client_id", "<api-key>")
	req.Header.Add("client_secret", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.usecobalt.com/v1/link/token/create")
  .header("client_id", "<api-key>")
  .header("client_secret", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"user_id\": \"<string>\",\n  \"org_id\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.usecobalt.com/v1/link/token/create")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["client_id"] = '<api-key>'
request["client_secret"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"user_id\": \"<string>\",\n  \"org_id\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "token": "<string>"
}

Creates a Link token that you’ll use to initialize the Link flow in your frontend application.

Request Body Parameters

Required Parameters

user_id (string) - A unique identifier for the end user from your system. Do not use PII like email or phone.
org_id (string) - A unique identifier for the organization from your system (e.g., clinic or hospital ID).

Optional Parameters (for creating new organizations)

If the org_id doesn’t exist yet, provide these parameters to create the organization:

emr_name (string) - The EMR system name. Contact support for a list of supported EMR systems.
emr_instance_domain (string) - The EMR instance URL (e.g., https://your-emr-instance.com)

Other Optional Parameters

access_token (string) - Include to use update mode for an existing connection

Example Request (Existing Organization)

curl -X POST https://api.usecobalt.com/link/token/create \
-H 'Content-Type: application/json' \
-H 'client_id: ci_live_198908HJDKJSH98789OHKJL' \
-H 'client_secret: cs_live_9827hofdsklOYYHJLJh' \
-d '{
    "user_id": "user_12345",
    "org_id": "org_67890"
}'

Example Request (New Organization)

curl -X POST https://api.usecobalt.com/link/token/create \
-H 'Content-Type: application/json' \
-H 'client_id: ci_live_198908HJDKJSH98789OHKJL' \
-H 'client_secret: cs_live_9827hofdsklOYYHJLJh' \
-d '{
    "user_id": "user_12345",
    "org_id": "org_67890",
    "emr_name": "YourEMRName",
    "emr_instance_domain": "https://your-emr-instance.com"
}'

Example Response

{
    "success": true,
    "token": "lt_198908HJDKJSH98789OHKJL"
}

Update Mode

To use update mode for an existing connection, include the access_token in your request:

curl -X POST https://api.usecobalt.com/link/token/create \
-H 'Content-Type: application/json' \
-H 'client_id: ci_live_198908HJDKJSH98789OHKJL' \
-H 'client_secret: cs_live_9827hofdsklOYYHJLJh' \
-d '{
    "user_id": "user_12345",
    "org_id": "org_67890",
    "access_token": "493JKLHIU98789hLKH9HHJH"
}'

The Link token is single-use and expires after 30 minutes.

Authorizations

client_id

string

header

required

client_secret

string

header

required

Body

application/json

user_id

string

org_id

string

Response

200 - application/json

Successful response

success

boolean

token

string

​Request Body Parameters

​Required Parameters

​Optional Parameters (for creating new organizations)

​Other Optional Parameters

​Example Request (Existing Organization)

​Example Request (New Organization)

​Example Response

​Update Mode

Authorizations

Body

Response

Request Body Parameters

Required Parameters

Optional Parameters (for creating new organizations)

Other Optional Parameters

Example Request (Existing Organization)

Example Request (New Organization)

Example Response

Update Mode