Standard objects

Companies

Customer and prospect companies — the core object every CRM record links to.

A company (customer in the API) is the center of the CRM. People, opportunities, visits, trials, quotes, orders, contracts, support tickets, and email threads all link to a company. The company card shows all of them on one page; in the API, GET /api/v1/customers/{id} returns the same content.

Status

Value Meaning
Prospect Prospect — a company you haven't sold to yet. The default for new companies.
AC Active customer. A company automatically becomes AC when an opportunity is won.

Companies are never deleted; they're deactivated (active: false). Inactive companies drop out of lists and reminders, and their history is preserved. The API has no delete endpoint; GET /api/v1/customers?active=0 lists inactive companies. Details: Archiving and deletion.

Fields

List endpoints return each company in the row format; the single-record endpoint returns the card format. The card includes every field in the row.

Field Type Description
id integer ID within the installation.
rid string 15-character permanent record ID (001…). Record IDs.
name string Company name (up to 200 characters).
status, status_label string AC / Prospect and its display name.
owner user Owning sales rep (id, full_name, role).
city, sector, phone string Contact details.
main_contact object The main contact's name, phone, email, and WhatsApp number (wa).
visit_state string Visit schedule: overdue overdue, soon coming up, ok, none no schedule.
last_visit, next_visit_due date Date of the last visit and of the next scheduled visit.
open_opps integer Number of open opportunities.
at_risk boolean The customer is at risk (no visits or orders for a long time).
potential_kg, unit number, string Monthly potential and the installation's base unit. Since v60, the sum of rows in the base unit when group rows exist. Units and currency.
currency string The company's transaction currency.
pending_state string Status of the most urgent open action.

The card also includes address, website, note, supplier_note (current supplier), barrier (obstacle), mgmt_support, visit_period_days, share fields (share_start, share_current, share_target), volume targets (our_kg_current, our_kg_target, commit_kg), contacts, opps, visits, demos, offers, orders, open_actions, events (timeline), competitors, prices, threads, categories (list) + categories_source (auto · ai · user), connection (strength 0–5, label, strongest_user_id, last_interaction, last_kind, next_interaction, next_kind, first_interaction, computed_at), tax_no · tax_office, potentials (v60: potential by product group — grp, potential, ours, share, share_target, gap, supplier; see Company potential) + pot (on, title), finance (when an ERP is connected: balance, overdue, credit_limit, risk_pct, open_invoices, open_amount, overdue_invoices, revenue_12m, avg_terms_days, last_invoice, accounts — Accounting & ERP; invoices via Company finance), and can_edit.

Logo, categories and connection strength

The company's logo appears in the card header and in every list (companies table, Actions, Emails, Notes, Pipeline, Dashboard, Today). It is fetched automatically from the company's own website: the Website field first, then the domain of a company created from email, then the corporate email domain of its people (generic addresses like Gmail don't count). The site is checked for apple-touch-icon, a large site icon and /favicon.ico, in that order; the image is stored on the installation and refreshed every 60 days. If no logo is found, the company's initial is shown in a coloured square. Refresh logo on the company card looks again right away.

People appear with their initials and opportunities with a stage ring: the ring takes the stage colour and fills to the stage the deal has reached (won is a green ✓, lost a grey ×).

The interaction strip on the company card (as in Attio):

Field How it is calculated
Connection strength Emails, meetings, visits (face-to-face weighs most), trials and call recordings from the last 365 days; each touchpoint is weighted by recency (halving every 45 days) and at most 3 emails a day per company count. Five levels: Very weak · Weak · Good · Strong · Very strong (None without any touchpoint). Not editable.
Strongest connection The team member with the most and most recent touchpoints.
Last interaction The latest email, meeting, visit or trial: when, what, who.
Next interaction The nearest scheduled meeting, or open task of type call / meeting / visit / email (within 120 days; cancelled meetings don't count).
First interaction The first email, meeting, visit or trial with the company.

Values are recalculated every three hours; opening a company card updates that company immediately.

Categories

Categories (Chemicals, Plastics & packaging, Metal & steel, Logistics & transport… — 32 industries) are detected automatically from the company name, its domain, the Sector field and the website's title / description, and are marked automatic. Pick them by hand with the pencil or type your own label — categories you set are never changed automatically again (Back to automatic undoes that). If AI is on, With AI picks 1–3 categories from the same list (AI receives only the company name, domain, sector and site description).

In the companies table, Categories, Connection strength, Strongest connection, Last interaction, Next interaction and First interaction can be added as columns, filtered, sorted and exported to Excel. Table views

Duplicate protection

When you create a company, its name is compared against existing companies:

  • If the same name exists (ignoring case, company-type suffixes, and punctuation), you get 409 exists, and the existing company is returned in the customer field.
  • If similar names exist, you get 409 similar, and the candidates are returned in the similar list. Pick the right company, or send confirm_new: true to create the new one anyway.

This rule is the same for create a company, log an activity, and inbound hooks (forms, data sync).

Automatically created companies

Email sync, form submissions, and the Segment and data sync hooks can create new companies. Companies created from email are identified by their domain (auto_domain) and show an "auto-created" (otomatik açıldı) banner on the company card; if the match is wrong, the user can undo it with one click.