REST API endpoints for CRM companies

Companies are organizational records in the Talkturo CRM. They act as a grouping layer above contacts — each contact belongs to a company, and each campaign is associated with one. You can store address, industry, size, and custom fields on a company, and the AI info extractor can update these fields automatically as calls complete.

Create a company

POST /api/crm/companies Creates a new company in your CRM.

Request body

string

required

The team ID that owns this company.

string

required

The company’s name.

string

The company’s website URL.

string

The industry the company operates in (for example, "SaaS", "Healthcare", "Finance").

string

A descriptor of the company’s size (for example, "1-10", "51-200", "1000+").

string

First line of the company’s street address.

string

Second address line (suite, floor, etc.).

string

City.

string

State or province.

string

Postal or ZIP code.

string

Country (for example, "US", "GB", "DE").

string

Company main phone number in E.164 format.

string

Free-text notes about the company.

object

Key-value object for any additional company-level data.

Example request

curl -X POST https://<your-domain>/api/crm/companies \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "teamId": "team_01j...",
    "name": "Acme Corporation",
    "website": "https://acme.example.com",
    "industry": "Manufacturing",
    "companySize": "500-1000",
    "city": "Chicago",
    "state": "IL",
    "country": "US",
    "customFields": {
      "crm_id": "acme-001",
      "account_tier": "enterprise"
    }
  }'

Response

{
  "success": true,
  "company": {
    "id": "comp_01j...",
    "team_id": "team_01j...",
    "name": "Acme Corporation",
    "website": "https://acme.example.com",
    "industry": "Manufacturing",
    "company_size": "500-1000",
    "phone": null,
    "address_line1": null,
    "address_line2": null,
    "city": "Chicago",
    "state": "IL",
    "postal_code": null,
    "country": "US",
    "notes": null,
    "custom_fields": {
      "crm_id": "acme-001",
      "account_tier": "enterprise"
    },
    "contact_count": 0,
    "created_at": "2024-01-15T10:00:00Z",
    "updated_at": "2024-01-15T10:00:00Z"
  }
}

string

Unique identifier for the company. Use this ID when creating contacts or campaigns.

string

The team this company belongs to.

string

Company name.

string

Company website URL.

string

Industry descriptor.

string

Company size descriptor.

string

Main company phone number.

string

First line of the street address.

string

Second line of the address.

string

City.

string

State or province.

string

Postal or ZIP code.

string

Country code.

string

Free-text notes.

object

Key-value pairs of custom company data.

integer

Number of contacts associated with this company.

string

ISO 8601 timestamp of when the company was created.

string

ISO 8601 timestamp of the most recent update.

List companies

GET /api/crm/companies Returns a paginated list of companies. You can filter by team or account, search by name, and filter by industry.

Query parameters

string

The team ID to list companies for. Provide either teamId or accountSlug.

string

Your account slug. Alternative to teamId.

string

Search by company name.

string

Filter by industry value.

integer

Maximum records to return. Defaults to 50.

integer

Records to skip for pagination. Defaults to 0.

Example request

curl "https://<your-domain>/api/crm/companies?teamId=team_01j...&industry=SaaS&limit=25" \
  -H "Authorization: Bearer <token>"

Response

{
  "success": true,
  "companies": [
    {
      "id": "comp_01j...",
      "team_id": "team_01j...",
      "name": "Acme Corporation",
      "website": "https://acme.example.com",
      "industry": "Manufacturing",
      "company_size": "500-1000",
      "contact_count": 42,
      "created_at": "2024-01-15T10:00:00Z",
      "updated_at": "2024-01-15T10:00:00Z"
    }
  ],
  "count": 1,
  "limit": 25,
  "offset": 0
}

array

Array of company objects.

integer

Total number of companies matching the filters.

integer

The limit value applied to this response.

integer

The offset value applied to this response.

When creating a campaign, you must supply a companyId. Create your company record first, then create contacts under it, then create the campaign.

Overview

Endpoints

Webhooks

REST API endpoints for CRM companies

Create a company

Request body

Example request

Response

List companies

Query parameters

Example request

Response

​Create a company

​Request body

​Example request

​Response

​List companies

​Query parameters

​Example request

​Response

Create a company

Request body

Example request

Response

List companies

Query parameters

Example request

Response