CRM Companies
Legacy reference for the deprecated CRM Companies API, including company retrieval, updates, deletion, contacts, and migration to CRM Groups.
curl -X GET "https://app.talkturo.com/api/crm/companies?page=1&limit=25&search=Acme" \
-H "Cookie: sb-session=example_session_cookie"
const response = await fetch(
"https://app.talkturo.com/api/crm/companies?page=1&limit=25&search=Acme",
{
method: "GET",
credentials: "include",
headers: {
"Content-Type": "application/json"
}
}
);
const data = await response.json();
console.log(data);
{
"success": true,
"companies": [
{
"id": "8b0c9f0d-9c9b-4d5b-9d4f-6d0c2c7f0132",
"name": "Acme Manufacturing",
"website": "https://acmemanufacturing.com",
"industry": "Manufacturing",
"phone": "+1-415-555-0142",
"address": "1450 Market Street, San Francisco, CA 94103"
},
{
"id": "d948c0e2-7ed3-4d94-a26b-c73db7fc32ea",
"name": "Northwind Health",
"website": "https://northwindhealth.com",
"industry": "Healthcare",
"phone": "+1-312-555-0188",
"address": "210 W Madison St, Chicago, IL 60606"
}
],
"total": 2,
"page": 1
}
Legacy CRM company records
Companies are deprecated and are being replaced by CRM Groups. Use the CRM Groups API for new integrations.
The legacy CRM Companies endpoints store organization records, attach custom fields, and retrieve contacts associated with each company.
Endpoints at a glance
| Method | Endpoint | Purpose | Status |
|---|---|---|---|
GET | /api/crm/companies | List companies | Deprecated |
POST | /api/crm/companies | Create a company | Deprecated: Returns 410 Gone |
GET | /api/crm/companies/{id} | Retrieve a company | Deprecated |
PATCH | /api/crm/companies/{id} | Update a company | Deprecated |
DELETE | /api/crm/companies/{id} | Delete a company | Deprecated |
GET | /api/crm/companies/{id}/contacts | List contacts for a company | Deprecated |
POST | /api/crm/companies/{id}/contacts | Add a contact to a company | Deprecated |
DELETE | /api/crm/companies/{id}/contacts | Remove a contact from a company | Deprecated |
Company object
Company responses return a company record with core fields such as id, name, website, and industry. Records may also include additional standard or custom CRM fields stored on the company.
Unique company identifier in UUID format.
Company name.
Company website URL when provided.
Industry label for the company.
Primary phone number for the company.
Company address.
List companies
Retrieve a paginated list of companies. Use search to filter results by a search term.
GET /api/crm/companies is deprecated but remains functional for backward compatibility. The request requires a teamId or accountSlug. Use the CRM Groups API for new integrations.
Query parameters
Team identifier used to scope the company records. The endpoint also accepts accountSlug for account-based scoping.
Page number to return.
Maximum number of companies to return per page.
Search term used to filter company records.
Response fields
Returns true when the request succeeds.
Array of company records for the current page.
Total number of matching company records.
Current page number in the paginated result.
Create a company
POST /api/crm/companies is deprecated and no longer creates company records. The endpoint returns HTTP 410 Gone; use POST /api/crm/groups instead.
Requests to create a company through POST /api/crm/companies return 410 Gone. Migrate clients to POST /api/crm/groups and follow the CRM Groups API reference.
Get a company
Retrieve a single company by its ID.
Path parameters
Unique company identifier in UUID format.
Response fields
Returns true when the company is found.
The requested company record.
Update a company
Update one or more fields on an existing company. Send only the fields you want to change.
Path parameters
Unique company identifier in UUID format.
Body parameters
Updated company name.
Updated website URL.
Updated industry label.
Updated primary phone number.
Updated company address.
Additional company fields to update. Include only the custom fields you want to change.
Response fields
Returns true when the update succeeds.
The updated company record.
Delete a company
Delete a company by its ID.
Path parameters
Unique company identifier in UUID format.
Response fields
Returns true when the company is deleted.
Deletion status message. Successful responses return Company deleted.
List contacts for a company
Retrieve the contacts associated with a specific company.
Path parameters
Unique company identifier in UUID format.
Response fields
Returns true when the request succeeds.
Array of contacts associated with the company.
Unique contact identifier.
Contact first name.
Contact last name.
Common patterns
Use GET /api/crm/companies when you need pagination and search across company records. Use GET /api/crm/companies/{id} when you already have the company ID and need the full record.
Create and update requests accept standard fields plus custom CRM fields. If your workspace defines additional fields on companies, include them directly in the JSON body using the field names configured in your CRM.