---
title: "Get a call action"
method: GET
path: "/call-actions/{id}"
tags: ["Call Actions"]
---

# Get a call action

`GET /call-actions/{id}`

Returns a single call action by ID. Scoped to the authenticated organization.

## Path parameters

- `id` string, required

## Response `200`

Call action

- object
  - `success` boolean
  - `data` CallAction — A call action that fires automatically at a specific point in the call lifecycle
    - `_id` string — MongoDB ObjectId
    - `organization` string — Organization ObjectId
    - `agentId` string — Agent ObjectId this action belongs to
    - `category` 'trigger' | 'post-call' — When the action fires
    - `provider` string — Integration provider (e.g. `hubspot`, `salesforce`)
    - `action_type` 'create' | 'update' — The operation performed on the provider object
    - `object` string — Provider object type (e.g. `contact`, `deal`)
    - `config` object
      - `phoneNumberFieldName` string — Provider field that contains the phone number (required for `trigger` actions)
      - `conditions` CallActionCondition[]
        - `field` string, required — Provider record field name
        - `operator` 'eq' | 'neq' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'nin' | 'contains' | 'notContains' | 'startsWith' | 'endsWith', required — Comparison operator
        - `value` string, required — Value to compare against
      - `body` string — Request body template or payload for the provider action
    - `createdAt` string, date-time
    - `updatedAt` string, date-time

## Other responses

- `400` — Invalid input
- `401` — Unauthorized access
- `404` — Call action not found
- `500` — Internal server error

---

[API](https://skmtc.net/smallest-inc/apis/agent-management-api.md) · [All operations](https://skmtc.net/smallest-inc/apis/agent-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smallest-inc/agent-management-api/revisions/c2d0eb64b01a/schema)