ClaraConverts

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.

Create a free, no-card ClaraConverts trial for a website, with every Pro feature (voice conversations included). Returns a working embed snippet and a bearer token for follow-up calls (get_embed_snippet, get_upgrade_link). Trial lasts 30 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.

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.

Get ClaraConverts pricing: the free 30-day trial (no card, every Pro feature — start it with create_trial_tenant) and the paid plans (Standard, Pro, Volume) in USD/month.

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.

Get a Stripe Checkout link to keep Clara after the trial — Pro by default, the plan every trial runs on. Requires the secret_key from create_trial_tenant, either as the secret_key argument or an "Authorization: Bearer <secret_key>" header.

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.

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

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.

Give Clara the site's content directly, for a site that isn't published yet (localhost, a preview URL, or still being built) so you can test Clara answering real questions before launch. Pass each page's text, markdown, or HTML. Replaces what Clara currently knows about the site; once the site is live, refresh_site_knowledge crawls it and replaces this. Requires the secret_key from create_trial_tenant, either as the secret_key argument or an "Authorization: Bearer <secret_key>" header.

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.