Skip to main content
POST
/
api
/
public
/
ticket
/
amount
Update the amount of a ticket
curl --request POST \
  --url https://api.vambe.me/api/public/ticket/amount \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "amount": 150000
}
'

​
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: 
x-api-key: your_api_key_here

​
Request Body

FieldTypeRequiredDescription
ticket_idstring (UUID)One of threeDirectly target a ticket by its ID.
ai_contact_idstring (UUID)One of threeFind the ticket through a contact ID.
contact_numberstringOne of threeFind the ticket through a contact phone number (e.g. +56912345678).
amountnumberYesThe amount to set on the ticket.
currencystringConditionalISO currency code (e.g. CLP, USD). Required for price-source tickets, ignored for metadata-source tickets.
allow_closed_ticketbooleanNoWhen true, falls back to the latest closed ticket if no active ticket exists. Defaults to false.
You must provide exactly one identifier: ticket_id, ai_contact_id, or contact_number.

​
Example Requests

​
By contact number

curl --request POST \
  'https://api.vambe.me/api/public/ticket/amount' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: your_api_key_here' \
  --data-raw '{
    "contact_number": "+56912345678",
    "amount": 150000,
    "currency": "CLP"
  }'

​
By AI contact ID (with closed ticket fallback)

curl --request POST \
  'https://api.vambe.me/api/public/ticket/amount' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: your_api_key_here' \
  --data-raw '{
    "ai_contact_id": "df980fc8-b6db-4820-bf22-2969482d106d",
    "allow_closed_ticket": true,
    "amount": 99990,
    "currency": "CLP"
  }'

​
By ticket ID

curl --request POST \
  'https://api.vambe.me/api/public/ticket/amount' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: your_api_key_here' \
  --data-raw '{
    "ticket_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "amount": 250000,
    "currency": "USD"
  }'

​
Responses

​
200 - Success

{
  "status": "ok"
}

​
400 - Bad Request

Returned when no identifier is provided, the request body is invalid, or currency is missing for a price-source ticket. 
{
  "statusCode": 400,
  "message": "You must provide ticket_id, ai_contact_id, or contact_number"
}

​
404 - Not Found

Returned when the contact or ticket cannot be found. 
{
  "statusCode": 404,
  "message": "Active ticket not found for contact"
}

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