Create company | AskElephant

curl -X POST https://app.askelephant.ai/api/v2/companies \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "domains": [
    {
      "domain": "examplecorp.com"
    }
  ]
}'

{
  "object": "company",
  "id": "cmp_9X7aB3kL2Q",
  "created_at": "2024-01-15T09:30:00Z",
  "updated_at": "2024-01-15T09:30:00Z",
  "name": "Example Corporation",
  "description": "A leading provider of innovative technology solutions for businesses worldwide.",
  "industry": "Information Technology",
  "website": "https://www.examplecorp.com",
  "number_of_employees": 350,
  "logo_url": "https://www.examplecorp.com/assets/logo.png",
  "crm_association": {
    "object_type": "account",
    "crm_object_id": "acc_123456789",
    "source": "Salesforce"
  },
  "domains": [
    {
      "domain": "examplecorp.com"
    }
  ]
}

Creates a workspace company. Requires the companies:write scope.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

domainslist of objectsRequired

namestringOptional1-255 characters

descriptionstringOptional1-2000 characters

Response headers

X-Api-Versionstring

Response

Created company response.

objectenum

Allowed values:

idstringformat: "^cmp_[A-Za-z0-9]+$"

created_atdatetime

updated_atdatetime

namestring or null

descriptionstring

industrystring

websitestringformat: "uri"

number_of_employeesinteger

logo_urlstringformat: "uri"

crm_associationobject

CRM record linked to this company. Present when the company has been matched to a CRM record via integration or API.

domainslist of objects

Errors

401

Unauthorized Error

403

Forbidden Error

409

Conflict Error

422

Unprocessable Entity Error

429

Too Many Requests Error

500

Internal Server Error