WIwithallo
CRM

Update company

Changed on

Updates an existing company. Only provided fields will be updated. Set custom attribute values with custom_attributes. A key that is not an active company attribute returns 400 CUSTOM_ATTRIBUTE_KEY_UNKNOWN, and a value of the wrong type returns 400 CUSTOM_ATTRIBUTE_VALUE_INVALID.

put/v2/api/crm/companies/{id}

Request

  • Base URL
    https://api.withallo.com
  • URL
    https://api.withallo.com/v2/api/crm/companies/{id}
  • Auth
    API key in header Authorization

Path parameters

idstring required
Example:com-xyz789

Company ID (e.g., "com-xyz789")

Request body

namestring nullable

Company name

websitestring nullable

Company website URL

industrystring nullable

Industry sector

custom_attributesobject nullable

Values for the company's custom attributes, keyed by attribute key. TEXT takes a string, NUMBER a finite JSON number (numeric strings are rejected), BOOLEAN a JSON boolean, DATE a YYYY-MM-DD string or ISO datetime, and DROPDOWN an option key or label (case-insensitive). Send null to clear a value; keys you omit are left untouched, and {} or omitting the field changes nothing. An unknown or archived key, or a value of the wrong type, rejects the whole request with CUSTOM_ATTRIBUTE_KEY_UNKNOWN or CUSTOM_ATTRIBUTE_VALUE_INVALID.

Example request

{
  "custom_attributes": {
    "ping_pong_level": "Advanced",
    "renewal_date": "2026-12-01"
  }
}

Response

Company updated

Example response

{
  "data": {
    "id": "com-xyz789",
    "name": "Acme Corp",
    "website": "https://acme.com",
    "industry": "Technology",
    "person_count": 3,
    "interactions": 12,
    "last_activity_at": "2026-04-28T10:30:00",
    "created_at": "2026-04-01T09:00:00",
    "updated_at": "2026-04-28T10:30:00",
    "custom_attributes": {
      "ping_pong_level": "advanced",
      "renewal_date": "2026-12-01"
    }
  }
}

Changes

  • 46c77103dd14Revision changes
    • info

      added the new optional request property

    • info

      added the non-success response with the status

    • info

      added the optional property / to the response with the status