---
title: "Create Action"
method: POST
path: "/v1/actions/create"
tags: ["actions"]
---

# Create Action

`POST /v1/actions/create`

## Request body

- union
  - TransferCallActionParams
    - `type` 'action_transfer_call', required
    - `config` TransferCallConfig, required
      - `phone_number` string, required
    - `action_trigger` union
      - FunctionCallActionTrigger
        - `type` 'action_trigger_function_call', required
        - `config` FunctionCallActionTriggerConfig
      - PhraseBasedActionTriggerInput
        - `type` 'action_trigger_phrase_based', required
        - `config` PhraseBasedActionTriggerConfig, required
          - `phrase_triggers` PhraseTrigger[], required
            - `phrase` string, required
            - `conditions` string[], required
  - EndConversationActionParams
    - `type` 'action_end_conversation', required
    - `config` EmptyActionConfig
    - `action_trigger` union
      - FunctionCallActionTrigger
        - `type` 'action_trigger_function_call', required
        - `config` FunctionCallActionTriggerConfig
      - PhraseBasedActionTriggerInput
        - `type` 'action_trigger_phrase_based', required
        - `config` PhraseBasedActionTriggerConfig, required
          - `phrase_triggers` PhraseTrigger[], required
            - `phrase` string, required
            - `conditions` string[], required
  - DTMFActionParams
    - `type` 'action_dtmf', required
    - `config` EmptyActionConfig
    - `action_trigger` FunctionCallActionTrigger
      - `type` 'action_trigger_function_call', required
      - `config` FunctionCallActionTriggerConfig
  - AddToConferenceActionParams
    - `type` 'action_add_to_conference', required
    - `config` AddToConferenceConfig, required
      - `phone_number` string, required
      - `place_primary_on_hold` boolean
    - `action_trigger` union
      - FunctionCallActionTrigger
        - `type` 'action_trigger_function_call', required
        - `config` FunctionCallActionTriggerConfig
      - PhraseBasedActionTriggerInput
        - `type` 'action_trigger_phrase_based', required
        - `config` PhraseBasedActionTriggerConfig, required
          - `phrase_triggers` PhraseTrigger[], required
            - `phrase` string, required
            - `conditions` string[], required
  - SetHoldActionParams
    - `type` 'action_set_hold', required
    - `config` EmptyActionConfig
    - `action_trigger` union
      - FunctionCallActionTrigger
        - `type` 'action_trigger_function_call', required
        - `config` FunctionCallActionTriggerConfig
      - PhraseBasedActionTriggerInput
        - `type` 'action_trigger_phrase_based', required
        - `config` PhraseBasedActionTriggerConfig, required
          - `phrase_triggers` PhraseTrigger[], required
            - `phrase` string, required
            - `conditions` string[], required
  - ExternalActionParams
    - `type` 'action_external', required
    - `config` ExternalActionConfig, required
      - `processing_mode` 'muted'
      - `name` string, required
      - `description` string, required
      - `url` string, required
      - `input_schema` object, required
      - `speak_on_send` boolean, required
      - `speak_on_receive` boolean, required
      - `signature_secret` string
    - `action_trigger` FunctionCallActionTrigger
      - `type` 'action_trigger_function_call', required
      - `config` FunctionCallActionTriggerConfig

## Response `200`

Successful Response

- union
  - TransferCallAction
    - `id` string, uuid, required
    - `user_id` string, uuid, required
    - `type` 'action_transfer_call', required
    - `config` TransferCallConfig, required
      - `phone_number` string, required
    - `action_trigger` union
      - FunctionCallActionTrigger
        - `type` 'action_trigger_function_call', required
        - `config` FunctionCallActionTriggerConfig
      - PhraseBasedActionTriggerOutput
        - `type` 'action_trigger_phrase_based', required
        - `config` PhraseBasedActionTriggerConfig, required
          - `phrase_triggers` PhraseTrigger[], required
            - `phrase` string, required
            - `conditions` string[], required
  - EndConversationAction
    - `id` string, uuid, required
    - `user_id` string, uuid, required
    - `type` 'action_end_conversation', required
    - `config` EmptyActionConfig
    - `action_trigger` union
      - FunctionCallActionTrigger
        - `type` 'action_trigger_function_call', required
        - `config` FunctionCallActionTriggerConfig
      - PhraseBasedActionTriggerOutput
        - `type` 'action_trigger_phrase_based', required
        - `config` PhraseBasedActionTriggerConfig, required
          - `phrase_triggers` PhraseTrigger[], required
            - `phrase` string, required
            - `conditions` string[], required
  - DTMFAction
    - `id` string, uuid, required
    - `user_id` string, uuid, required
    - `type` 'action_dtmf', required
    - `config` EmptyActionConfig
    - `action_trigger` FunctionCallActionTrigger
      - `type` 'action_trigger_function_call', required
      - `config` FunctionCallActionTriggerConfig
  - AddToConferenceAction
    - `id` string, uuid, required
    - `user_id` string, uuid, required
    - `type` 'action_add_to_conference', required
    - `config` AddToConferenceConfig, required
      - `phone_number` string, required
      - `place_primary_on_hold` boolean
    - `action_trigger` union
      - FunctionCallActionTrigger
        - `type` 'action_trigger_function_call', required
        - `config` FunctionCallActionTriggerConfig
      - PhraseBasedActionTriggerOutput
        - `type` 'action_trigger_phrase_based', required
        - `config` PhraseBasedActionTriggerConfig, required
          - `phrase_triggers` PhraseTrigger[], required
            - `phrase` string, required
            - `conditions` string[], required
  - SetHoldAction
    - `id` string, uuid, required
    - `user_id` string, uuid, required
    - `type` 'action_set_hold', required
    - `config` EmptyActionConfig
    - `action_trigger` union
      - FunctionCallActionTrigger
        - `type` 'action_trigger_function_call', required
        - `config` FunctionCallActionTriggerConfig
      - PhraseBasedActionTriggerOutput
        - `type` 'action_trigger_phrase_based', required
        - `config` PhraseBasedActionTriggerConfig, required
          - `phrase_triggers` PhraseTrigger[], required
            - `phrase` string, required
            - `conditions` string[], required
  - ExternalAction
    - `id` string, uuid, required
    - `user_id` string, uuid, required
    - `type` 'action_external', required
    - `config` ExternalActionConfig, required
      - `processing_mode` 'muted'
      - `name` string, required
      - `description` string, required
      - `url` string, required
      - `input_schema` object, required
      - `speak_on_send` boolean, required
      - `speak_on_receive` boolean, required
      - `signature_secret` string
    - `action_trigger` FunctionCallActionTrigger
      - `type` 'action_trigger_function_call', required
      - `config` FunctionCallActionTriggerConfig

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/vocodedev/apis/vocode-hosted-api.md) · [All operations](https://skmtc.net/vocodedev/apis/vocode-hosted-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vocodedev/vocode-hosted-api/revisions/ffca17c004e2/schema)