Skip to main content
POST
/
companies
Create a new company record
curl --request POST \
  --url https://api.klipy.ai/api/v1/companies \
  --header 'Content-Type: application/json' \
  --header 'X-KLIPY-API-KEY: <api-key>' \
  --data '
{
  "domain": "<string>",
  "name": "<string>",
  "description": "A software company specializing in AI solutions",
  "address": "123 Main St",
  "city": "San Francisco",
  "state": "CA",
  "country": "USA",
  "linkedin": "company/example-corp",
  "twitter": "examplecorp",
  "facebook": "examplecorp",
  "instagram": "examplecorp",
  "crunchbase": "organization/example-corp",
  "phone": "+1234567890",
  "remarks": "Potential enterprise client"
}
'
{
  "success": true,
  "data": {
    "id": "<string>"
  }
}

Authorizations

​
X-KLIPY-API-KEY
string
header
required

Body

application/json

Company record to create

​
domain
string
required

Domain of the company

​
name
string
required

Name of the company

​
description
string | null

Description of the company

Example:

"A software company specializing in AI solutions"

​
address
string | null

Street address of the company

Example:

"123 Main St"

​
city
string | null

City where the company is located

Example:

"San Francisco"

​
state
string | null

State where the company is located

Example:

"CA"

​
country
string | null

Country where the company is located

Example:

"USA"

​
linkedin
string | null

LinkedIn profile without the https://linkedin.com/ prefix

Example:

"company/example-corp"

​
twitter
string | null

Twitter handle

Example:

"examplecorp"

​
facebook
string | null

Facebook profile without the https://facebook.com/ prefix

Example:

"examplecorp"

​
instagram
string | null

Instagram handle

Example:

"examplecorp"

​
crunchbase
string | null

Crunchbase profile without the https://www.crunchbase.com/ prefix

Example:

"organization/example-corp"

​
phone
string | null

Company phone number

Example:

"+1234567890"

​
remarks
string | null

Additional notes or remarks

Example:

"Potential enterprise client"

Response

Success

​
success
boolean
​
data
object