Submit a structured proposal request to Kratons on behalf of a traveller or a travel agent: contact, destinations within Spain/Portugal/Morocco, dates, travellers, total budget, interests. Returns a reference. A human advisor replies by e-mail — there is no automatic booking, no online checkout and no price list. Send idempotencyKey to retry safely.
View input schema
{
"type": "object",
"properties": {
"contact": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 120,
"description": "Traveller's (or the person to reply to) full name"
},
"email": {
"type": "string",
"format": "email",
"maxLength": 254,
"description": "E-mail address a human advisor will reply to"
},
"phone": {
"type": "string",
"maxLength": 40,
"description": "Phone / WhatsApp number with country code"
},
"preferredChannel": {
"type": "string",
"enum": [
"email",
"phone",
"whatsapp",
"video_call"
]
},
"language": {
"type": "string",
"enum": [
"en",
"es"
],
"description": "Language for the reply (English or Spanish)"
}
},
"required": [
"name",
"email"
],
"additionalProperties": false
},
"trip": {
"type": "object",
"properties": {
"destinations": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 60
},
"minItems": 1,
"maxItems": 12,
"description": "Countries, regions or cities within Spain, Portugal and/or Morocco"
},
"dates": {
"type": "object",
"properties": {
"start": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "YYYY-MM-DD"
},
"end": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "YYYY-MM-DD"
},
"month": {
"type": "string",
"pattern": "^\\d{4}-(0[1-9]|1[0-2])$",
"description": "YYYY-MM when exact dates are not fixed"
},
"flexible": {
"type": "boolean",
"default": false
}
},
"additionalProperties": false
},
"nights": {
"type": "integer",
"minimum": 1,
"maximum": 90
},
"travelers": {
"type": "object",
"properties": {
"adults": {
"type": "integer",
"minimum": 1,
"maximum": 40
},
"children": {
"type": "integer",
"minimum": 0,
"maximum": 40,
"default": 0
},
"ages": {
"type": "array",
"items": {
"type": "integer",
"minimum": 0,
"maximum": 120
},
"maxItems": 40,
"description": "Ages of children (and adults if relevant)"
}
},
"required": [
"adults"
],
"additionalProperties": false
},
"budgetTotal": {
"type": "number",
"minimum": 0,
"maximum": 5000000,
"description": "Approximate total budget for the WHOLE trip"
},
"currency": {
"type": "string",
"enum": [
"EUR",
"USD"
],
"default": "EUR"
},
"interests": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 60
},
"maxItems": 20,
"default": [],
"description": "Interests and preferred pace"
},
"accommodationStyle": {
"type": "string",
"maxLength": 200
},
"hotelPreferences": {
"type": "object",
"properties": {
"level": {
"type": "string",
"enum": [
"3_star",
"4_star",
"5_star",
"luxury",
"boutique",
"historic_or_parador",
"mixed"
],
"description": "Hotel level the traveller expects; 'mixed' when it may vary by city"
},
"names": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"maxItems": 10,
"description": "Specific hotels the traveller has in mind, by name"
},
"notes": {
"type": "string",
"maxLength": 500,
"description": "Anything else about accommodation (room types, location, must-haves)"
}
},
"additionalProperties": false,
"description": "Accommodation preferences by level or by hotel name (2026-09-17)"
},
"occasion": {
"type": "string",
"maxLength": 200,
"description": "Anniversary, birthday, honeymoon…"
},
"needs": {
"type": "string",
"maxLength": 2000,
"description": "Mobility or dietary needs"
},
"notes": {
"type": "string",
"maxLength": 4000,
"description": "Anything else the advisor should know"
}
},
"required": [
"destinations",
"dates",
"travelers"
],
"additionalProperties": false
},
"requester": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"ai_agent",
"travel_agent",
"traveller"
],
"default": "ai_agent"
},
"agentName": {
"type": "string",
"maxLength": 120,
"description": "Name of the assistant or agency submitting this"
},
"agentVendor": {
"type": "string",
"maxLength": 120,
"description": "Vendor / platform of the assistant (e.g. OpenAI, Anthropic)"
}
},
"additionalProperties": false,
"default": {
"kind": "ai_agent"
}
},
"idempotencyKey": {
"type": "string",
"maxLength": 120,
"description": "Send the same key to retry safely; the same reference comes back"
},
"source": {
"type": "string",
"enum": [
"social",
"web",
"agent",
"referral",
"other"
],
"description": "Where this request originated, e.g. \"social\" when the traveller followed a link in one of Kratons' social posts"
},
"socialPostId": {
"type": "string",
"pattern": "^[0-9a-fA-F]{24}$",
"description": "The Kratons social post the traveller came from, when the link carried it"
},
"utm": {
"type": "object",
"properties": {
"source": {
"type": "string",
"maxLength": 100
},
"medium": {
"type": "string",
"maxLength": 100
},
"campaign": {
"type": "string",
"maxLength": 100
}
},
"additionalProperties": false,
"description": "UTM parameters of the landing link, when any"
}
},
"required": [
"contact",
"trip"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}