Skip to main content
POST
/
api
/
v1
/
accounts
/
{account_id}
/
companies
Create a company
curl --request POST \
  --url https://connect.voxys.ai/api/v1/accounts/{account_id}/companies \
  --header 'Content-Type: application/json' \
  --header 'api_access_token: <api-key>' \
  --data '
{
  "name": "Acme Corp",
  "domain": "acme.com",
  "description": "Global leader in widgets.",
  "custom_attributes": {
    "industry": "Technology",
    "annual_revenue": 500000
  }
}
'
{
  "id": 10,
  "name": "Acme Corp",
  "domain": "acme.com",
  "description": "Global leader in widgets.",
  "custom_attributes": {
    "industry": "Technology",
    "annual_revenue": 500000
  },
  "contacts_count": 5,
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

Documentation Index

Fetch the complete documentation index at: https://developers.voxys.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
api_access_token
string
header
required

API access token for authentication. Obtain from your Voxys Connect profile settings.

Path Parameters

​
account_id
integer
required

The numeric ID of the account.

Body

application/json
​
name
string
required
Example:

"Acme Corp"

​
domain
string | null
Example:

"acme.com"

​
description
string | null
Example:

"Global leader in widgets."

​
custom_attributes
object

Flexible key-value map of custom attributes defined for the account.

Example:
{
  "industry": "Technology",
  "annual_revenue": 500000
}

Response

Company created.

​
id
integer
Example:

10

​
name
string
Example:

"Acme Corp"

​
domain
string | null
Example:

"acme.com"

​
description
string | null
Example:

"Global leader in widgets."

​
custom_attributes
object

Flexible key-value map of custom attributes defined for the account.

Example:
{
  "industry": "Technology",
  "annual_revenue": 500000
}
​
contacts_count
integer
Example:

5

​
created_at
string<date-time>
​
updated_at
string<date-time>