Create Workspace (API Token)

Create workspace (API token)

curl --request POST \
  --url https://www.tryunleashx.com/api/v1/global/create-workspace \
  --header 'Content-Type: application/json' \
  --header 'token: <token>' \
  --data '
{
  "workspace_name": "<string>"
}
'

import requests

url = "https://www.tryunleashx.com/api/v1/global/create-workspace"

payload = { "workspace_name": "<string>" }
headers = {
    "token": "<token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {token: '<token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({workspace_name: '<string>'})
};

fetch('https://www.tryunleashx.com/api/v1/global/create-workspace', 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://www.tryunleashx.com/api/v1/global/create-workspace",
  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([
    'workspace_name' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "token: <token>"
  ],
]);

$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://www.tryunleashx.com/api/v1/global/create-workspace"

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

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

	req.Header.Add("token", "<token>")
	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://www.tryunleashx.com/api/v1/global/create-workspace")
  .header("token", "<token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"workspace_name\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://www.tryunleashx.com/api/v1/global/create-workspace")

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

request = Net::HTTP::Post.new(url)
request["token"] = '<token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"workspace_name\": \"<string>\"\n}"

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

{
  "message": "WORKSPACE_CREATED_SUCCESSFULLY",
  "data": {
    "WORKSPACE_ID": 123,
    "WORKSPACE_NAME": "<string>",
    "COMPANY_ID": 123,
    "OWNER_ID": 123,
    "CONCURRENCY": 123,
    "WORKSPACE_STATUS": 123
  }
}

POST

create-workspace

Create workspace (API token)

curl --request POST \
  --url https://www.tryunleashx.com/api/v1/global/create-workspace \
  --header 'Content-Type: application/json' \
  --header 'token: <token>' \
  --data '
{
  "workspace_name": "<string>"
}
'

import requests

url = "https://www.tryunleashx.com/api/v1/global/create-workspace"

payload = { "workspace_name": "<string>" }
headers = {
    "token": "<token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {token: '<token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({workspace_name: '<string>'})
};

fetch('https://www.tryunleashx.com/api/v1/global/create-workspace', 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://www.tryunleashx.com/api/v1/global/create-workspace",
  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([
    'workspace_name' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "token: <token>"
  ],
]);

$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://www.tryunleashx.com/api/v1/global/create-workspace"

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

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

	req.Header.Add("token", "<token>")
	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://www.tryunleashx.com/api/v1/global/create-workspace")
  .header("token", "<token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"workspace_name\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://www.tryunleashx.com/api/v1/global/create-workspace")

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

request = Net::HTTP::Post.new(url)
request["token"] = '<token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"workspace_name\": \"<string>\"\n}"

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

{
  "message": "WORKSPACE_CREATED_SUCCESSFULLY",
  "data": {
    "WORKSPACE_ID": 123,
    "WORKSPACE_NAME": "<string>",
    "COMPANY_ID": 123,
    "OWNER_ID": 123,
    "CONCURRENCY": 123,
    "WORKSPACE_STATUS": 123
  }
}

Create a new workspace under your API token’s company. This delegates to the same internal controller used by the company-side /api/company/create-workspace endpoint, so both entry points always stay in sync.

API Endpoint

POST /api/v1/global/create-workspace Base URL: https://www.tryunleashx.com Authentication: Required (Token header: token or api_access_token)

Request Body

Field	Type	Required	Description
`workspace_name`	string	Yes	Name for the new workspace. Must be unique among active workspaces in the token’s company.

Success Response

Status Code: 200 OK

{
  "error": false,
  "code": 200,
  "message": "",
  "timestamp": 1769243432947,
  "data": {
    "message": "WORKSPACE_CREATED_SUCCESSFULLY",
    "data": {
      "WORKSPACE_ID": 301,
      "WORKSPACE_NAME": "Growth Team",
      "COMPANY_ID": 42,
      "OWNER_ID": 7,
      "CONCURRENCY": 5,
      "WORKSPACE_STATUS": 1
    }
  }
}

Response Fields

Field	Type	Description
`WORKSPACE_ID`	integer	Unique identifier of the newly created workspace
`WORKSPACE_NAME`	string	Name of the workspace
`COMPANY_ID`	integer	Company the workspace belongs to
`OWNER_ID`	integer	User who created the workspace
`CONCURRENCY`	integer	Default concurrent-call limit for the workspace
`WORKSPACE_STATUS`	integer	`1` = active

Access Control

The token resolves to a user and a company; the workspace is always created under that company. Creating a workspace also seeds its default settings, adds the creator (and the company owner, if different) as a workspace admin, seeds the creator’s domain whitelist entry, and triggers the same workspace_created notification email as the company-side endpoint.

Errors

Status	Message	Cause
`422`	`WORKSPACE_NAME_ALREADY_EXISTS`	An active workspace with this name already exists for the company

Example cURL

curl -X POST "https://www.tryunleashx.com/api/v1/global/create-workspace" \
  -H "token: <api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "workspace_name": "Growth Team"
  }'

List Workspaces — fetch the newly created workspace_id

Headers

token

string

required

API token for authentication

Body

application/json

workspace_name

string

required

Name for the new workspace. Must be unique within the token's company.

Response

Workspace created successfully

message

string

Example:

"WORKSPACE_CREATED_SUCCESSFULLY"

data

object

Show child attributes

API Documentation

Phone Numbers

Voice AI

Click to Call

Call Logs

Campaigns

Audience

Segment

Input Variables

Workspaces

Users

Create Workspace (API Token)

API Endpoint

Request Body

Success Response

Response Fields

Access Control

Errors

Example cURL

Headers

Body

Response

​API Endpoint

​Request Body

​Success Response

​Response Fields

​Access Control

​Errors

​Example cURL

​Related Operations

Headers

Body

Response

API Endpoint

Request Body

Success Response

Response Fields

Access Control

Errors

Example cURL

Related Operations