Skip to main content
POST
https://api.gocobalt.io
/
api
/
v2
/
public
/
connect-url
curl --request POST \
  --url https://api.gocobalt.io/api/v2/public/connect-url \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer {Session_token}' \
  --data '{
  "color": "<string>",
  "bgColor": "<string>",
  "name": "<string>"
}'

{
    "hosted_url": "https://connect.gocobalt.io/eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJvcmdfaWQiOiI2M2M5M2RhMGI0NmI3MjQzNzg1YTFlMTciLCJsaW5rZWRfYWNjb3VudF9pZCI6IjEyMzQ1Njc4IiwiZW52aXJvbm1lbnQiOiJ0ZXN0IiwiaWF0IjoxNjg2NzM1ODMxLCJleHAiOjE2ODY5OTUwMzF9.DOKY6iXkfjLcSK8vIqtQ1mHuh92pZMhlddladdovGL8"
}
Returns the connection URL in format: https://connect.gocobalt.io/{TOKEN}

​
Request description

​
Headers

​
Authorization
string
Unlike other API’s in this documentation, this API requires the Session token as a bearer token for authentication.
curl --request POST \
  --url https://api.gocobalt.io/api/v2/public/connect-url \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer {Session_token}' \
  --data '{
  "color": "<string>",
  "bgColor": "<string>",
  "name": "<string>"
}'

​
Query Parameters

​
config_id
string
Config ID to be used for creating Hosted URL
If the config_id is not found, then a new config will be created using the config_id.

​
Body Parameters

​
color
string
Text Colour Hex
​
bgColor
string
Background Colour Hex
​
name
string
Customer name

​
Response description

​
hosted_url
string
Hosted Auth-Flow URL
{
    "hosted_url": "https://connect.gocobalt.io/eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJvcmdfaWQiOiI2M2M5M2RhMGI0NmI3MjQzNzg1YTFlMTciLCJsaW5rZWRfYWNjb3VudF9pZCI6IjEyMzQ1Njc4IiwiZW52aXJvbm1lbnQiOiJ0ZXN0IiwiaWF0IjoxNjg2NzM1ODMxLCJleHAiOjE2ODY5OTUwMzF9.DOKY6iXkfjLcSK8vIqtQ1mHuh92pZMhlddladdovGL8"
}