Add Action to Telephone Encounter

Documentation Index

Fetch the complete documentation index at: https://docs.usecobalt.com/llms.txt

Use this file to discover all available pages before exploring further.

​

Request Parameters

​

Required Fields

• emr_appointment_id (string, required): The EMR-specific ID of the telephone encounter
• text (string, required): The action text/note to add to the telephone encounter log

​

How It Works

1. Formatting: The action is automatically formatted with the staff member’s name, timestamp, and timezone
2. Appending: The formatted action is appended to the existing action log in the telephone encounter
3. Timestamping: Each action includes the exact date, time, and timezone when it was added

​

Example Request

curl -X POST https://api.usecobalt.com/v1/telephone-encounters/actions \
-H 'Content-Type: application/json' \
-H 'client_id: ci_live_198908HJDKJSH98789OHKJL' \
-H 'client_secret: cs_live_9827hofdsklOYYHJLJh' \
-H 'access_token: 493JKLHIU98789hLKH9HHJH' \
-d '{
    "emr_appointment_id": "3784895",
    "text": "Patient called for prescription refill"
}'

​

Example Response

{
  "success": true,
  "message": "Action processing. A webhook event will be sent upon completion.",
  "action_id": "a7b8c9d0e1f2g3h4i5j6k7l8m9n0o1p2",
  "job_id": 12345
}

​

Response Fields

• success (boolean): Indicates if the request was accepted for processing
• message (string): Confirmation message
• action_id (string): Unique identifier for the action record (32-character hex string)
• job_id (integer): Reference to the job that will process this action

​

Webhook Events

​

Success Event

{
  "id": "evt_abc123",
  "object": "event",
  "type": "telephone_encounter_action.created",
  "created": "2026-01-21T20:15:30.000Z",
  "job_id": "12345",
  "access_token_reference_id": "user_123",
  "data": {
    "action_id": "a7b8c9d0e1f2g3h4i5j6k7l8m9n0o1p2",
    "emr_appointment_id": "3784895",
    "text": "Patient called for prescription refill"
  }
}