​

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

​

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

​

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:

​

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