Skip to main content
POST
Update the amount of a ticket

Overview

Updates the amount of a ticket. The amount represents the monetary value associated with the ticket (e.g. the deal value). By default, this endpoint targets the contact’s active ticket. Set allow_closed_ticket to true to fall back to the latest closed ticket when no active ticket exists.
Whether currency is required depends on how the ticket type is configured:
  • Price-source tickets: currency is required.
  • Metadata-source tickets: the amount is written to the configured custom field and currency is ignored.

Authentication

Include your API key in the request headers:

Request Body

You must provide exactly one identifier: ticket_id, ai_contact_id, or contact_number.

Example Requests

By contact number

By AI contact ID (with closed ticket fallback)

By ticket ID

Responses

200 - Success

400 - Bad Request

Returned when no identifier is provided, the request body is invalid, or currency is missing for a price-source ticket.

404 - Not Found

Returned when the contact or ticket cannot be found.

Headers

x-api-key
string
required

API key needed to authorize the request

Body

application/json
amount
number
required
ticket_id
string<uuid>
ai_contact_id
string<uuid>
contact_number
string
currency
string
Example:

"CLP"

allow_closed_ticket
boolean

Response

Ticket amount updated successfully