---
title: "Smokeball API: connect it to your AI chat · Hypamoon"
description: "The Smokeball API is documented, but access goes through Smokeball first. What it takes to connect it to your AI chat with Hypamoon, with sources."
url: https://hypamoon.com/connect-to/smokeball
---

1.  [Connect to](https://hypamoon.com/connect-to)
2.  Smokeball

Legal and accountancy

# Connect Smokeball to Hypamoon

Possible, with help from Smokeball. The API is documented, but you cannot just create a key: access goes through Smokeball first.

Possible

## The check

Three questions about the API of Smokeball, answered from its own docs.

**Public API docs**\
**Yes.** Public API documentation with guides and reference. [Read the docs](https://docs.smokeball.com/llms.txt)

**A key you create yourself**\
**No.** Integrations go through partner approval and a security review before production credentials are given. [docs.smokeball.com](https://docs.smokeball.com/docs/platform-docs/8j90k123i567j-partner-program.md)

**Versions or a changelog**\
**Yes.** Release notes in chronological order. [docs.smokeball.com](https://docs.smokeball.com/docs/api-docs/98439555e1d41-release-notes.md)

**How it signs in**\
OAuth 2.0 authorization code or client credentials, with scopes.

**Webhooks**\
**Yes.** It can tell your app when something changes. [docs.smokeball.com](https://docs.smokeball.com/docs/api-docs/wivbkstcwngb5-webhooks.md)

**Hosting**\
Cloud

**Condition**\
Production credentials only after Smokeball's partner approval and security review.

## What you can build

Read matters and contacts from Smokeball into your own intake flow, after Smokeball approves the integration.

Your chat writes it as a Hypamoon adapter from the docs above. Reading starts after you click Allow in the portal, and every write waits for your approval, one call at a time. [How adapters work](https://hypamoon.com/docs/adapters)

### Good to know

-   Smokeball signs in with OAuth or signed requests only, with tokens that expire. The Hypamoon vault holds a fixed key today, so an adapter for Smokeball takes more work: ask your chat to check this first.
-   Staging and production accounts are managed in the Smokeball developer console.

## Try it in your chat

First get access from Smokeball. Then fill in what to read and write, and send it.

Say this in your chat

> Build the Hypamoon recipe build-an-adapter for Smokeball. API docs: https://docs.smokeball.com/. Read: \[what\]. Write: \[what, or nothing\].

[Open in Claude](https://claude.ai/new?q=Build%20the%20Hypamoon%20recipe%20build-an-adapter%20for%20Smokeball.%20API%20docs%3A%20https%3A%2F%2Fdocs.smokeball.com%2F.%20Read%3A%20%5Bwhat%5D.%20Write%3A%20%5Bwhat%2C%20or%20nothing%5D.)

In Claude, or another chat with the full Hypamoon connection; adapters are not in ChatGPT yet. You paste the key in the portal, never in the chat. [The full recipe](https://hypamoon.com/r/build-an-adapter)

## Sources

Checked on 7 November 2026.

-   [docs.smokeball.com/llms.txt](https://docs.smokeball.com/llms.txt)
-   [docs.smokeball.com/docs/platform-docs/8j90k123i567j-partner-program.md](https://docs.smokeball.com/docs/platform-docs/8j90k123i567j-partner-program.md)
-   [docs.smokeball.com/docs/api-docs/98439555e1d41-release-notes.md](https://docs.smokeball.com/docs/api-docs/98439555e1d41-release-notes.md)
-   [docs.smokeball.com/docs/api-docs/wivbkstcwngb5-webhooks.md](https://docs.smokeball.com/docs/api-docs/wivbkstcwngb5-webhooks.md)

Smokeball is a name of its owner, used here only to describe the software. This page is not an official integration and Hypamoon has no partnership with Smokeball. Found something that changed? Tell us at [support](https://hypamoon.com/support#contact).

## More in legal and accountancy

-   [**BaseNet** Closed](https://hypamoon.com/connect-to/basenet)
-   [**Clio** Open](https://hypamoon.com/connect-to/clio)
-   [**PracticePanther** Possible](https://hypamoon.com/connect-to/practicepanther)
-   [**Actionstep** Possible](https://hypamoon.com/connect-to/actionstep)

[All 1094 tools](https://hypamoon.com/connect-to)

## Tool not listed? Ask the chat to check its API.

The same three checks work for any software. Your chat reads the vendor's own docs and tells you what it found.

Say this in your chat

> Check if \[software\] has an open API that a Hypamoon adapter can use: public API docs, a key or token I can create myself without asking the vendor, and versions or a changelog. Link the pages you used.

[Open in Claude](https://claude.ai/new?q=Check%20if%20%5Bsoftware%5D%20has%20an%20open%20API%20that%20a%20Hypamoon%20adapter%20can%20use%3A%20public%20API%20docs%2C%20a%20key%20or%20token%20I%20can%20create%20myself%20without%20asking%20the%20vendor%2C%20and%20versions%20or%20a%20changelog.%20Link%20the%20pages%20you%20used.) [Open in ChatGPT](https://chatgpt.com/?q=Check%20if%20%5Bsoftware%5D%20has%20an%20open%20API%20that%20a%20Hypamoon%20adapter%20can%20use%3A%20public%20API%20docs%2C%20a%20key%20or%20token%20I%20can%20create%20myself%20without%20asking%20the%20vendor%2C%20and%20versions%20or%20a%20changelog.%20Link%20the%20pages%20you%20used.)

Fill in the name of your software. Checking needs no connection to Hypamoon.

## Ready to connect Smokeball?

Connect your chat once, then ask it to build the adapter.

[Start free](https://app.hypamoon.com/?mode=signup&utm_source=connect-to&utm_campaign=smokeball)

Works in Claude, ChatGPT and Copilot. [Add to Claude](https://hypamoon.com/connect?via=connect-to~smokeball#claude) [Add to ChatGPT](https://hypamoon.com/connect?via=connect-to~smokeball#chatgpt) [Add to Copilot](https://hypamoon.com/docs/microsoft-copilot)
