Skip to main content
POST
/
api
/
v1
/
business
/
context

​
Set Business Context Variables

Set business context variables for your account. These variables can be used for personalization in AI calls, templates, and other communications.

​
Endpoint

POST /api/v1/business/context

​
Authentication

This endpoint requires an API key with the can_write_contacts permission.

​
Request Body

ParameterTypeRequiredDescription
variablesobjectYesMap of variable names to values
auto_create_variablesbooleanNoWhether to automatically create undefined variables

​
Example Request Body

{
  "variables": {
    "office_hours": "9 AM - 5 PM EST",
    "support_phone": "+18005551234",
    "pricing_tier": "Enterprise"
  },
  "auto_create_variables": true
}

​
Response

{
  "message": "Business context variables updated successfully"
}

​
Error Codes

Status CodeError CodeDescription
400invalid_jsonInvalid JSON payload
400invalid_valueA variable value doesn’t match its defined type
400undefined_variableA variable is not defined (when auto_create_variables is false)
401authentication_requiredNo API key was provided
401invalid_keyThe API key is invalid or inactive
403permission_deniedThe API key doesn’t have the required permission
500server_errorAn unexpected server error occurred

​
Example Request

curl -X POST 'https://api.klen.ai/api/v1/business/context' \
  -H 'Authorization: Bearer klen_abcdef123456789' \
  -H 'Content-Type: application/json' \
  -d '{
    "variables": {
      "office_hours": "9 AM - 5 PM EST",
      "support_phone": "+18005551234",
      "pricing_tier": "Enterprise"
    },
    "auto_create_variables": true
  }'

​
Example Response

{
  "message": "Business context variables updated successfully"
}

​
Data Type Validation

Values are validated against the variable’s defined type:
TypeValid ValuesExamples
textAny string"Premium Support"
numberNumbers, numeric strings250.50, "42"
dateISO date strings"2023-12-01", "2023-01-15T14:30:00Z"
booleanBoolean values, boolean stringstrue, false, "true", "yes", "1"
selectValue from predefined optionsMust match one of the defined options

​
Auto-Creating Variables

When auto_create_variables is set to true:
  • If a variable name is not already defined, the system will create a new definition
  • The variable type will be inferred from the value
  • The display name will be generated from the variable name (e.g., office_hours → “Office Hours”)
When auto_create_variables is false (default):
  • All variable names must already be defined
  • Attempting to set an undefined variable will result in an error

​
Notes

  • Business context variables apply to your entire account and can be used in all communications
  • These variables are prefixed with business_ when used in templates (e.g., business_office_hours)
  • For select type variables, the value must match one of the defined options
  • Variable values are stored in your business profile
  • Setting a variable to null will remove it from your business context