canonical: https://jentic.com/apis/www.callfire.com/callfire

# CallFire API Documentation

CallFire API Documentation provides programmatic access to communications functionality. The API exposes 107 endpoints secured with basic authentication.

## For AI agents

Programmatically send calls, find calls. Covers 107 operations with basic authentication.

## Scope

Does not handle payments, crm, or developer tools - use for communications only.

## Capabilities

- Send calls
- Find calls
- Update a batch
- Create an IVR
- Monitor CallFire API Documentation operational status and events

## Use cases

### Communications Operations

Use the CallFire API Documentation to perform communications operations programmatically. The API provides 107 endpoints covering core functionality including send calls, find calls, find a specific call.

Example prompt: Call POST /calls to send calls

### Automated keyword-leases Management

Automate keyword-leases operations by combining multiple CallFire API Documentation endpoints. Agents can find calls and then find a specific call in a single workflow.

Example prompt: Call GET /calls to find calls, then verify the result

### AI Agent Integration via Jentic

AI agents discover and call CallFire API Documentation endpoints through Jentic without managing credentials directly. An agent searches for the required operation by intent, receives the matching endpoint schema, and executes the call with Jentic-managed authentication. This eliminates the need to read API documentation or handle basic tokens manually.

Example prompt: Search Jentic for 'send calls', load the operation schema, and execute with Jentic-managed credentials

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | /calls | Send calls |
| GET | /calls | Find calls |
| GET | /calls/{id} | Find a specific call |
| GET | /campaigns/batches/{id} | Find a specific batch |
| PUT | /campaigns/batches/{id} | Update a batch |
| POST | /campaigns/ivrs | Create an IVR |
| GET | /campaigns/ivrs | Find IVRs |
| GET | /campaigns/ivrs/{id} | Find a specific IVR |

## Key resources

- **keyword-leases** — Operations related to keyword-leases
- **campaigns** — Operations related to campaigns
- **campaign-sounds** — Operations related to campaign-sounds
- **keywords** — Operations related to keywords
- **numbers** — Operations related to numbers

## Why Jentic

- **Setup:** Wiring the CallFire API by hand means setting up its basic auth and managing calls and campaigns across 107 operations yourself. Through Jentic you install once, import the CallFire API from the API Directory, store the credential once, and your agent calls it.
- **Permission scoping:** The CallFire API puts the call or campaign id in the URL path (/calls/{id}, /campaigns/batches/{id}), so a rule can pin your agent to one call or campaign batch. You choose the operations it may call, so send-call actions and batch updates are not included unless you add them, and read-only lookups can stand alone.
- **Credential handling:** Your CallFire API credential is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'send calls' or 'get a campaign batch', and Jentic returns the matching CallFire API operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Twilio** — Alternative communications API
- **Sendgrid** — Alternative communications API
- **Pusher** — Complementary communications API

## FAQ

### What authentication does the CallFire API Documentation use?

The CallFire API Documentation uses HTTP Basic authentication with username and password. Through Jentic, these credentials are stored encrypted in your Jentic One instance and injected at execution time, so raw secrets never enter the agent context.

### Can I send calls with the CallFire API Documentation?

Yes. Use the POST /calls endpoint. The API returns structured JSON responses that agents can parse and act on directly.

### What are the rate limits for the CallFire API Documentation?

Rate limits are not specified in the OpenAPI spec. Check the vendor documentation for current limits. Through Jentic, rate limiting is handled automatically with retry logic built into the execution layer.

### How do I send calls through Jentic?

Install the Jentic SDK with pip install jentic, authenticate through Jentic One, the self-hosted execution layer, then search for 'send calls'. Jentic returns the matching CallFire API Documentation operation with its input schema. Load the schema and execute the call - credentials are injected automatically.

### How many endpoints does the CallFire API Documentation have?

The CallFire API Documentation exposes 107 endpoints covering keyword-leases, campaigns, campaign-sounds operations.

### Can I limit what my agent is allowed to do with the CallFire API?

Yes. Because you run Jentic One yourself, your own rules decide which CallFire operations and credentials the agent may use. Since CallFire puts the call or campaign id in the URL path (/calls/{id}, /campaigns/batches/{id}), you can pin the agent to a single call or campaign batch and grant only read-only lookups such as GET /calls. Write actions like POST /calls to send calls or PUT /campaigns/batches/{id} to update a batch are excluded unless you explicitly add them.
