ClaraConverts

Get ClaraConverts plan pricing (Standard, Pro, Volume) in USD/month.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

List the CRM, booking, commerce, payments, and other integrations ClaraConverts can connect to.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Create a free, no-card ClaraConverts trial for a website. Returns a working embed snippet and a bearer token for follow-up calls (get_embed_snippet, get_upgrade_link). Trial lasts 14 days. One live trial per owner_email — provisioning multiple sites (e.g. for an agency's clients) isn't supported by these tools yet; each site needs its own contact email for now.

{
  "type": "object",
  "properties": {
    "owner_email": {
      "type": "string",
      "description": "The site owner's real, monitored email — this is the only place their Studio login link and trial-expiry reminders go. Ask the human for it; don't invent one or reuse an address found elsewhere (required)."
    },
    "site_url": {
      "type": "string",
      "description": "URL of the site Clara will be installed on (required)."
    },
    "display_name": {
      "type": "string",
      "description": "Optional display name for the business."
    },
    "conversion_goal": {
      "type": "string",
      "description": "Optional: what Clara should drive (e.g. \"book a demo\", \"capture a lead\")."
    }
  },
  "required": [
    "owner_email",
    "site_url"
  ],
  "additionalProperties": false
}

Get the <script> embed snippet for your trial tenant. Requires the secret_key from create_trial_tenant, either as the secret_key argument or an "Authorization: Bearer <secret_key>" header.

{
  "type": "object",
  "properties": {
    "secret_key": {
      "type": "string",
      "description": "The secret_key returned by create_trial_tenant, if your client can't send it as an \"Authorization: Bearer <secret_key>\" header instead."
    }
  },
  "additionalProperties": false
}

Read back your trial tenant's current persona/widget settings and which integrations are connected — the read counterpart to update_tenant_settings and configure_integration, useful for confirming a change actually took or resuming work without re-guessing current state. Requires the secret_key from create_trial_tenant, either as the secret_key argument or an "Authorization: Bearer <secret_key>" header.

{
  "type": "object",
  "properties": {
    "secret_key": {
      "type": "string",
      "description": "The secret_key returned by create_trial_tenant, if your client can't send it as an \"Authorization: Bearer <secret_key>\" header instead."
    }
  },
  "additionalProperties": false
}

Update your trial tenant's persona and widget settings (name, goal, branding, position, lead notification email). Only the fields you pass are changed. Requires the secret_key from create_trial_tenant, either as the secret_key argument or an "Authorization: Bearer <secret_key>" header.

{
  "type": "object",
  "properties": {
    "secret_key": {
      "type": "string",
      "description": "The secret_key returned by create_trial_tenant, if your client can't send it as an \"Authorization: Bearer <secret_key>\" header instead."
    },
    "display_name": {
      "type": "string",
      "description": "Business/display name shown in the widget chrome."
    },
    "site_url": {
      "type": "string",
      "description": "The site Clara is installed on."
    },
    "conversion_goal": {
      "type": "string",
      "description": "What Clara should drive (e.g. \"book a demo\", \"capture a lead\")."
    },
    "brand_color": {
      "type": "string",
      "description": "Hex color, e.g. \"#0b5ed7\"."
    },
    "widget_position": {
      "type": "string",
      "enum": [
        "top_left",
        "top_center",
        "top_right",
        "middle_left",
        "middle_center",
        "middle_right",
        "bottom_left",
        "bottom_center",
        "bottom_right"
      ],
      "description": "Where the widget bubble docks."
    },
    "lead_destination": {
      "type": "string",
      "description": "Email address captured leads are sent to."
    },
    "outbound_webhook": {
      "type": "string",
      "description": "Optional webhook URL for lead notifications (Zapier/Make/etc.)."
    },
    "language": {
      "type": "string",
      "enum": [
        "auto",
        "en-us",
        "en-gb",
        "es-es",
        "es-419",
        "fr",
        "it",
        "pt",
        "hi",
        "ja",
        "zh",
        "de",
        "ar"
      ],
      "description": "\"auto\" detects from the visitor's browser, or pin a fixed language."
    },
    "voice_id": {
      "type": "string",
      "description": "Voice for spoken replies (only honored on the Pro plan — safe to set now for after an upgrade)."
    },
    "chatbot_name": {
      "type": "string",
      "description": "Override the AI's name (defaults to \"Clara\")."
    },
    "chatbot_avatar_url": {
      "type": "string",
      "description": "URL of a custom avatar image for the widget."
    }
  },
  "additionalProperties": false
}

Re-crawl your site and update what Clara knows about it. Trials skip the crawl at creation to stay fast, so Clara knows nothing about your business until this runs at least once. Can take up to a minute for a large site. Requires the secret_key from create_trial_tenant, either as the secret_key argument or an "Authorization: Bearer <secret_key>" header.

{
  "type": "object",
  "properties": {
    "secret_key": {
      "type": "string",
      "description": "The secret_key returned by create_trial_tenant, if your client can't send it as an \"Authorization: Bearer <secret_key>\" header instead."
    }
  },
  "additionalProperties": false
}

List the meeting types on a Cal.com account by name (with account timezone). Call this BEFORE configure_integration with provider="calcom" — its required event_type_id can't be typed from memory, it has to be picked from this list. Requires the secret_key from create_trial_tenant, either as the secret_key argument or an "Authorization: Bearer <secret_key>" header.

{
  "type": "object",
  "properties": {
    "secret_key": {
      "type": "string",
      "description": "The secret_key returned by create_trial_tenant, if your client can't send it as an \"Authorization: Bearer <secret_key>\" header instead."
    },
    "api_key": {
      "type": "string",
      "description": "The Cal.com API key to look up meeting types for."
    }
  },
  "required": [
    "api_key"
  ],
  "additionalProperties": false
}

Connect an integration from list_integrations to your trial tenant. For API-key providers, pass api_key and any required config fields and it connects immediately (Cal.com needs list_calcom_event_types called first for event_type_id — every other provider's config fields are typed directly from that provider's own dashboard). For OAuth providers (Shopify, HubSpot, Google Calendar, Square, ...), returns a connect_url a human must open and approve — it can't be completed headlessly. Requires the secret_key from create_trial_tenant, either as the secret_key argument or an "Authorization: Bearer <secret_key>" header.

{
  "type": "object",
  "properties": {
    "secret_key": {
      "type": "string",
      "description": "The secret_key returned by create_trial_tenant, if your client can't send it as an \"Authorization: Bearer <secret_key>\" header instead."
    },
    "provider": {
      "type": "string",
      "description": "The integration name from list_integrations, e.g. \"calcom\"."
    },
    "api_key": {
      "type": "string",
      "description": "The provider's API key/token, for API-key-based providers."
    },
    "config": {
      "type": "object",
      "description": "Provider-specific config fields (see the provider's configFields — e.g. Cal.com needs event_type_id)."
    }
  },
  "required": [
    "provider"
  ],
  "additionalProperties": false
}

Get a Stripe Checkout link to upgrade your trial tenant to a paid plan. Requires the secret_key from create_trial_tenant, either as the secret_key argument or an "Authorization: Bearer <secret_key>" header.

{
  "type": "object",
  "properties": {
    "secret_key": {
      "type": "string",
      "description": "The secret_key returned by create_trial_tenant, if your client can't send it as an \"Authorization: Bearer <secret_key>\" header instead."
    },
    "tier": {
      "type": "string",
      "enum": [
        "standard",
        "pro",
        "volume"
      ],
      "description": "Plan to upgrade to."
    }
  },
  "required": [
    "tier"
  ],
  "additionalProperties": false
}