CRM Companies
Create, list, update, delete, and retrieve companies in the Talkturo CRM — manage organization records with custom fields and contact associations.
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
}
curl -X POST "https://app.talkturo.com/api/crm/companies" \
-H "Content-Type: application/json" \
-H "Cookie: sb-session=example_session_cookie" \
-d '{
"name": "Acme Manufacturing",
"website": "https://acmemanufacturing.com",
"industry": "Manufacturing",
"phone": "+1-415-555-0142",
"address": "1450 Market Street, San Francisco, CA 94103",
"employee_count": 240,
"account_owner": "Maya Patel"
}'
const response = await fetch("https://app.talkturo.com/api/crm/companies", {
method: "POST",
credentials: "include",
headers: {
"Content-Type": "application/json"
},
body: JSON.stringify({
name: "Acme Manufacturing",
website: "https://acmemanufacturing.com",
industry: "Manufacturing",
phone: "+1-415-555-0142",
address: "1450 Market Street, San Francisco, CA 94103",
employee_count: 240,
account_owner: "Maya Patel"
})
});
const data = await response.json();
console.log(data);
{
"success": true,
"company": {
"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",
"employee_count": 240,
"account_owner": "Maya Patel"
}
}
Manage CRM company records
Use the CRM Companies endpoints to store organization records, attach custom fields, and retrieve contacts associated with each company.
All CRM Companies endpoints require session cookie authentication. Send requests from an authenticated Talkturo session.
Endpoints at a glance
| Method | Endpoint | Purpose |
|---|---|---|
GET | /api/crm/companies | List companies |
POST | /api/crm/companies | Create a company |
GET | /api/crm/companies/{id} | Retrieve a company |
PATCH | /api/crm/companies/{id} | Update a company |
DELETE | /api/crm/companies/{id} | Delete a company |
GET | /api/crm/companies/{id}/contacts | List contacts for a company |
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.
Query parameters
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
Create a new company record by sending the company name and any additional fields you want to store.
Body parameters
Company name.
Company website URL.
Industry label for the company.
Primary company phone number.
Company address.
Any additional CRM fields to store on the company record. Custom field names and value types depend on your CRM configuration.
Response fields
Returns true when the company is created successfully.
The created company record, including its generated id.
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.