# API: Add Ticket Timer

# addTicketTimer

Add timer to a ticket.

# Required parameters

Parameter Description
ticket_number Ticket number
name Timer name

# Optional parameters

Parameter Description
start_datetime Timer start date like 2024-06-17 04:00:00. Default now
timezone Timezone like Europe/Warsaw
auto_reset Timer will be canceled when client adds a new reply to the ticket
macro[reply] Add a reply to ticket
macro[admin_note] Add a admin note to ticket
macro[notify] Send email notifications about Ticket reply
macro[sub_email] Email ID to send notifications to subscribed staff members
macro[status] Change status. Allowed values: 'Open','Closed','Answered','In-Progress','Client-Reply'
macro[priority] Change priority. Allowed integer values: 0 - Low, 1 - Medium, 2 - High
macro[owner] Admin ID to assign
macro[subscribers][] Admin ID to add to subscriber list
macro[tags][] Tags to add
macro[tags_rem][] Tags to remove
macro[deptid] Department ID to change

# Request

GET /admin/api.php?api_id=API_ID&api_key=API_KEY&call=addTicketTimer&ticket_number=TICKET_NUMBER&name=NAME

# PHP Samples

# PHP Samples: Add ticket timer without macro with default start date

# PHP Samples: Add ticket timer without macro and with start date, timezone and auto reset to cancel timer when client adds a new reply

# PHP Samples: Add ticket timer with macro

# Response

{
    "success": true,
    "call": "addTicketTimer",
    "server_time": 1498201522,
    "info": [
        "Timer added"
    ],
    "timer_id": [
        "20"
    ]
}
Last Updated: 7/28/2025, 2:10:08 PM