DELETEa company

DELETE /user-api/v1/companies/:id

Path Parameters

id
string

Company ID

Query Parameters

include
string

Related data to include: custom_fields, tags, lists, contacts

Endpoint Example

DELETE /user-api/v1/companies/company_67890?include=tags,lists,contacts,custom_fields

Response

{
  "data": {
    "id": "company_67890",
    "name": "TechStart Inc",
    "description": "Innovative startup focused on AI solutions",
    "headquarters_location": "Austin, TX",
    "linkedin_slug": "techstart-inc",
    "website_url": "<https://techstart.com>",
    "x_slug": null,
    "facebook_slug": null,
    "instagram_slug": null,
    "email": "hello@techstart.com",
    "country_code": "+1",
    "phone_number": "5559876543",
    "arr_estimate": 1500000,
    "number_of_employees": 65,
    "is_starred": false,
    "ignore_merge": false,
    "last_team_interaction": null,
    "team_members_connected": 0,
    "created_at": "2025-01-15T10:30:00Z",
    "updated_at": "2025-01-15T12:45:00Z",
    "tags": [
      {
        "tag": {
          "id": "tag_123",
          "name": "Startup"
        }
      },
      {
        "tag": {
          "id": "tag_999",
          "name": "Series A"
        }
      }
    ],
    "lists": [
      {
        "list": {
          "id": "list_789",
          "name": "Q1 Prospects"
        }
      }
    ],
    "contacts": [
      {
        "id": "contact_101",
        "full_name": "Sarah Johnson",
        "image_url": null
      }
    ],
    "custom_fields": [
      {
        "id": "field_123",
        "name": "Industry Vertical",
        "field_type": "SINGLE_LINE_TEXT",
        "value": "AI & Machine Learning"
      }
    ]
  }
}