Update the amount of a ticket
Tickets
Update the amount of a ticket
Updates the amount of the active ticket, or the latest closed ticket if allow_closed_ticket is true. Provide ticket_id, ai_contact_id, or contact_number to identify the ticket. currency is required for price-source tickets and ignored for metadata-source tickets. For email contacts always provide ticket_id: their tickets are per-thread, so resolution by ai_contact_id or contact_number may return no ticket or one from a different thread.
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. Setallow_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:
currencyis required. - Metadata-source tickets: the amount is written to the configured custom field and
currencyis ignored.
Authentication
Include your API key in the request headers:Request Body
You must provide exactly one identifier:ticket_id,ai_contact_id, orcontact_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, orcurrency is missing for a price-source ticket.
