apis.yml

aid: thoughtly
name: Thoughtly
url: https://raw.githubusercontent.com/api-evangelist/thoughtly/refs/heads/main/apis.yml
description: |
  Thoughtly is an AI voice and chat agent platform that helps revenue and support
  teams contact every lead across every channel — voice, SMS, email, WhatsApp,
  and iMessage. The product combines a no-code agent designer (decision-tree
  builder, Vibes AI assistant, Genius knowledge base), a managed telephony layer
  (purchased numbers, branded calling, BYOC, voice cloning), and a public REST
  API for programmatically creating contacts, triggering outbound calls, and
  subscribing to call-completion webhooks. Thoughtly integrates natively with
  Salesforce, HubSpot, Zoho, GoHighLevel, Keap, Pipedrive, Attio, Calendly,
  Acuity, Cal.com, Mindbody, Gmail, Slack, Zendesk, Shopify, Zapier, and Make.
type: Index
deliveryModel:
  model: saas
  open_source: false
  commercial: true
  callable_host: true
  label: Hosted service · you call their endpoint
  confidence: high
  source:
  - openapi
  - pricing
  generated: '2026-08-28'
  method: derived
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: medium
  source:
  - plans
  - authentication
  - security
  generated: '2026-09-03'
  method: derived
position: Producing
access: 3rd-Party
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/thoughtly.png
tags:
  - Voice AI
  - Chat AI
  - Conversational AI
  - AI Agents
  - Outbound Calling
  - Inbound Calling
  - Lead Conversion
  - SMS
  - WhatsApp
  - CRM
  - Telephony
created: '2026-05-24'
modified: '2026-05-24'
specificationVersion: '0.23'
apis:
- aid: thoughtly:thoughtly-agent-api
  name: Thoughtly agent API
  description: Voice and chat agent operations. Agents are referenced as "interviews" in URLs.
  humanURL: https://docs.thoughtly.com/developers
  baseURL: https://api.thoughtly.com
  tags:
  - Agents
  tags_raw:
  - agent
  properties:
  - type: OpenAPI
    url: openapi/thoughtly-agent-api-openapi.yml
  - type: Documentation
    url: https://docs.thoughtly.com/developers
  - type: Documentation
    url: https://docs.thoughtly.com/api-reference
  - type: SpectralRules
    url: rules/thoughtly-rules.yml
  - type: JSONSchema
    url: json-schema/thoughtly-contact-schema.json
  - type: JSONSchema
    url: json-schema/thoughtly-agent-schema.json
  - type: JSONSchema
    url: json-schema/thoughtly-call-schema.json
  - type: JSONSchema
    url: json-schema/thoughtly-webhook-schema.json
  - type: JSONStructure
    url: json-structure/thoughtly-contact-structure.json
  - type: JSONStructure
    url: json-structure/thoughtly-call-structure.json
  - type: JSONLD
    url: json-ld/thoughtly-context.jsonld
  - type: Examples
    url: examples/thoughtly-create-contact-example.json
  - type: Examples
    url: examples/thoughtly-call-contact-example.json
  - type: Examples
    url: examples/thoughtly-subscribe-webhook-example.json
  - type: Examples
    url: examples/thoughtly-new-response-webhook-example.json
  - type: Webhooks
    url: https://docs.thoughtly.com/integrations/webhooks
  - type: Documentation
    url: https://docs.thoughtly.com/automations/getting-started
  - type: Authentication
    url: https://app.thoughtly.com/settings/developer
- aid: thoughtly:thoughtly-contact-api
  name: Thoughtly contact API
  description: Contact management — create, retrieve, update, and call contacts.
  humanURL: https://docs.thoughtly.com/developers
  baseURL: https://api.thoughtly.com
  tags:
  - Contact
  tags_raw:
  - contact
  properties:
  - type: OpenAPI
    url: openapi/thoughtly-contact-api-openapi.yml
  - type: Documentation
    url: https://docs.thoughtly.com/developers
  - type: Documentation
    url: https://docs.thoughtly.com/api-reference
  - type: SpectralRules
    url: rules/thoughtly-rules.yml
  - type: JSONSchema
    url: json-schema/thoughtly-contact-schema.json
  - type: JSONSchema
    url: json-schema/thoughtly-agent-schema.json
  - type: JSONSchema
    url: json-schema/thoughtly-call-schema.json
  - type: JSONSchema
    url: json-schema/thoughtly-webhook-schema.json
  - type: JSONStructure
    url: json-structure/thoughtly-contact-structure.json
  - type: JSONStructure
    url: json-structure/thoughtly-call-structure.json
  - type: JSONLD
    url: json-ld/thoughtly-context.jsonld
  - type: Examples
    url: examples/thoughtly-create-contact-example.json
  - type: Examples
    url: examples/thoughtly-call-contact-example.json
  - type: Examples
    url: examples/thoughtly-subscribe-webhook-example.json
  - type: Examples
    url: examples/thoughtly-new-response-webhook-example.json
  - type: Webhooks
    url: https://docs.thoughtly.com/integrations/webhooks
  - type: Documentation
    url: https://docs.thoughtly.com/automations/getting-started
  - type: Authentication
    url: https://app.thoughtly.com/settings/developer
- aid: thoughtly:thoughtly-user-api
  name: Thoughtly user API
  description: Authenticated user details.
  humanURL: https://docs.thoughtly.com/developers
  baseURL: https://api.thoughtly.com
  tags:
  - User
  tags_raw:
  - user
  properties:
  - type: OpenAPI
    url: openapi/thoughtly-user-api-openapi.yml
  - type: Documentation
    url: https://docs.thoughtly.com/developers
  - type: Documentation
    url: https://docs.thoughtly.com/api-reference
  - type: SpectralRules
    url: rules/thoughtly-rules.yml
  - type: JSONSchema
    url: json-schema/thoughtly-contact-schema.json
  - type: JSONSchema
    url: json-schema/thoughtly-agent-schema.json
  - type: JSONSchema
    url: json-schema/thoughtly-call-schema.json
  - type: JSONSchema
    url: json-schema/thoughtly-webhook-schema.json
  - type: JSONStructure
    url: json-structure/thoughtly-contact-structure.json
  - type: JSONStructure
    url: json-structure/thoughtly-call-structure.json
  - type: JSONLD
    url: json-ld/thoughtly-context.jsonld
  - type: Examples
    url: examples/thoughtly-create-contact-example.json
  - type: Examples
    url: examples/thoughtly-call-contact-example.json
  - type: Examples
    url: examples/thoughtly-subscribe-webhook-example.json
  - type: Examples
    url: examples/thoughtly-new-response-webhook-example.json
  - type: Webhooks
    url: https://docs.thoughtly.com/integrations/webhooks
  - type: Documentation
    url: https://docs.thoughtly.com/automations/getting-started
  - type: Authentication
    url: https://app.thoughtly.com/settings/developer
- aid: thoughtly:thoughtly-webhooks-api
  name: Thoughtly webhooks API
  description: Webhook subscription, unsubscription, and automation triggers.
  humanURL: https://docs.thoughtly.com/developers
  baseURL: https://api.thoughtly.com
  tags:
  - Webhook
  tags_raw:
  - webhooks
  properties:
  - type: OpenAPI
    url: openapi/thoughtly-webhooks-api-openapi.yml
  - type: Documentation
    url: https://docs.thoughtly.com/developers
  - type: Documentation
    url: https://docs.thoughtly.com/api-reference
  - type: SpectralRules
    url: rules/thoughtly-rules.yml
  - type: JSONSchema
    url: json-schema/thoughtly-contact-schema.json
  - type: JSONSchema
    url: json-schema/thoughtly-agent-schema.json
  - type: JSONSchema
    url: json-schema/thoughtly-call-schema.json
  - type: JSONSchema
    url: json-schema/thoughtly-webhook-schema.json
  - type: JSONStructure
    url: json-structure/thoughtly-contact-structure.json
  - type: JSONStructure
    url: json-structure/thoughtly-call-structure.json
  - type: JSONLD
    url: json-ld/thoughtly-context.jsonld
  - type: Examples
    url: examples/thoughtly-create-contact-example.json
  - type: Examples
    url: examples/thoughtly-call-contact-example.json
  - type: Examples
    url: examples/thoughtly-subscribe-webhook-example.json
  - type: Examples
    url: examples/thoughtly-new-response-webhook-example.json
  - type: Webhooks
    url: https://docs.thoughtly.com/integrations/webhooks
  - type: Documentation
    url: https://docs.thoughtly.com/automations/getting-started
  - type: Authentication
    url: https://app.thoughtly.com/settings/developer
common:
  - type: PostmanWorkspace
    url: https://www.postman.com/kinlaneapi/thoughtly/overview
  - type: AgenticAccess
    url: agentic-access/thoughtly-agentic-access.yml
  - type: TrustCenter
    url: security/thoughtly-trust-center.yml
  - type: DomainSecurity
    url: security/thoughtly-domain-security.yml
  - type: Authentication
    url: authentication/thoughtly-authentication.yml
  - type: Website
    url: https://thoughtly.com
  - type: Portal
    url: https://docs.thoughtly.com
  - type: Documentation
    url: https://docs.thoughtly.com/developers
  - type: Documentation
    url: https://docs.thoughtly.com/api-reference
  - type: GettingStarted
    url: https://docs.thoughtly.com/getting-started/quick-start
  - type: Signup
    url: https://app.thoughtly.com/signup
  - type: Login
    url: https://app.thoughtly.com/login
  - type: Authentication
    url: https://app.thoughtly.com/settings/developer
  - type: Pricing
    url: https://docs.thoughtly.com/platform/billing
  - type: Plans
    url: plans/thoughtly-plans-pricing.yml
  - type: RateLimits
    url: rate-limits/thoughtly-rate-limits.yml
  - type: FinOps
    url: finops/thoughtly-finops.yml
  - type: ChangeLog
    url: https://docs.thoughtly.com/support/changelog
  - type: Support
    url: https://docs.thoughtly.com/support/getting-help
  - type: FAQ
    url: https://docs.thoughtly.com/resources/faq
  - type: Glossary
    url: https://docs.thoughtly.com/resources/glossary/overview
  - type: Whitepapers
    url: https://docs.thoughtly.com/resources/whitepapers/overview
  - type: VideoLibrary
    url: https://docs.thoughtly.com/resources/video-library
  - type: Integrations
    url: https://docs.thoughtly.com/integrations/getting-started
  - type: Webhooks
    url: https://docs.thoughtly.com/integrations/webhooks
  - type: Automations
    url: https://docs.thoughtly.com/automations/getting-started
  - type: KnowledgeBase
    url: https://docs.thoughtly.com/genius/getting-started
  - type: AgentBuilder
    url: https://docs.thoughtly.com/build/agent-builder/overview
  - type: PhoneNumbers
    url: https://docs.thoughtly.com/phone-number/getting-started
  - type: Voices
    url: https://docs.thoughtly.com/agents/voices
  - type: BlogPost
    url: https://thoughtly.com/blog
    name: Thoughtly Blog
  - type: LinkedIn
    url: https://www.linkedin.com/company/thoughtly-ai/
  - type: Twitter
    url: https://twitter.com/thoughtlyai
  - type: AffiliateProgram
    url: https://docs.thoughtly.com/promptbooks/joining-the-thoughtly-affiliate-program
  - type: ReferralProgram
    url: https://docs.thoughtly.com/support/referral-program
  - type: Promptbooks
    url: https://docs.thoughtly.com/promptbooks/browse
  - type: Vocabulary
    url: vocabulary/thoughtly-vocabulary.yml
  - type: Integrations
    url: https://docs.thoughtly.com/integrations/crm/salesforce
    name: Salesforce
  - type: Integrations
    url: https://docs.thoughtly.com/integrations/crm/hubspot
    name: HubSpot
  - type: Integrations
    url: https://docs.thoughtly.com/integrations/crm/zoho
    name: Zoho CRM
  - type: Integrations
    url: https://docs.thoughtly.com/integrations/crm/highlevel
    name: GoHighLevel
  - type: Integrations
    url: https://docs.thoughtly.com/integrations/crm/pipedrive
    name: Pipedrive
  - type: Integrations
    url: https://docs.thoughtly.com/integrations/crm/attio
    name: Attio
  - type: Integrations
    url: https://docs.thoughtly.com/integrations/crm/keap
    name: Keap
  - type: Integrations
    url: https://docs.thoughtly.com/integrations/scheduling/calendly
    name: Calendly
  - type: Integrations
    url: https://docs.thoughtly.com/integrations/scheduling/acuity
    name: Acuity Scheduling
  - type: Integrations
    url: https://docs.thoughtly.com/integrations/scheduling/cal-com
    name: Cal.com
  - type: Integrations
    url: https://docs.thoughtly.com/integrations/scheduling/mindbody
    name: Mindbody
  - type: Integrations
    url: https://docs.thoughtly.com/integrations/communication/gmail
    name: Gmail
  - type: Integrations
    url: https://docs.thoughtly.com/integrations/communication/slack
    name: Slack
  - type: Integrations
    url: https://docs.thoughtly.com/integrations/communication/whatsapp-business
    name: WhatsApp Business
  - type: Integrations
    url: https://docs.thoughtly.com/integrations/ticketing/zendesk
    name: Zendesk
  - type: Integrations
    url: https://docs.thoughtly.com/integrations/e-commerce/shopify
    name: Shopify
  - type: Integrations
    url: https://docs.thoughtly.com/integrations/productivity/google-sheets
    name: Google Sheets
  - type: Integrations
    url: https://docs.thoughtly.com/integrations/productivity/airtable
    name: Airtable
  - type: Integrations
    url: https://docs.thoughtly.com/integrations/productivity/typeform
    name: Typeform
  - type: Integrations
    url: https://docs.thoughtly.com/integrations/productivity/trello
    name: Trello
  - type: Integrations
    url: https://docs.thoughtly.com/integrations/productivity/smartsheet
    name: Smartsheet
  - type: Integrations
    url: https://docs.thoughtly.com/integrations/productivity/zoom
    name: Zoom
  - type: Integrations
    url: https://docs.thoughtly.com/integrations/automations/zapier
    name: Zapier
  - type: Integrations
    url: https://docs.thoughtly.com/integrations/automations/make
    name: Make
  - type: Features
    data:
      - No-code Agent Builder with decision-tree nodes, variables, outcomes, and branching logic
      - Vibes AI assistant for generating and editing agent workflows from natural language
      - Genius knowledge base (RAG) for grounding agents in customer documents and data
      - Voice library plus voice cloning and Bring Your Own Key (BYOK) TTS
      - Branded calling, Bring Your Own Carrier (BYOC), and phone number purchase/management
      - Public REST API for agents, contacts, calls, webhooks, and automations
      - Webhook events NEW_RESPONSE, PHONE_TRANSFER, FOLDER_NEW_RESPONSE, FOLDER_PHONE_TRANSFER, ACTION_FAILED
      - Webhook-triggered Automations for chaining Agent calls with HTTP, CRM, SMS, and email steps
      - Omnichannel agents — voice → SMS → email → WhatsApp follow-up cadence
      - Bulk upload + bulk call workflows with Audiences segmentation
      - Multilingual agents and call screening bypass
      - Mid-call SMS and mid-call website lookup actions
      - Analytics dashboard, audit log, and call history with outcome classification
      - Workspaces with role-based access and team invites
      - Native integrations with 25+ tools including Salesforce, HubSpot, Zapier, Make, and Shopify
      - 100 requests per minute API rate limit; subscriber 429s retried once with Retry-After
    sources:
      - https://thoughtly.com/
      - https://docs.thoughtly.com/developers
      - https://docs.thoughtly.com/api-reference
      - https://docs.thoughtly.com/integrations/getting-started
      - https://docs.thoughtly.com/integrations/webhooks
      - https://docs.thoughtly.com/platform/billing
    updated: '2026-05-24'
maintainers:
  - FN: Kin Lane
    email: kin@apievangelist.com
    url: https://apievangelist.com