# Custom API

**Integrations - Catalogue - Custom API - Connect** links any REST API with a base URL and one auth header for the agent to call mid-conversation.

  <ShotPlaceholder
    src="/assets/integrations/custom-api.png"
    name="custom-api-connect"
    alt="Connect Custom API base URL and auth header"
    capture="Connect Custom API dialog."
  />

## What you enter

- **API base URL** (required) — Root URL, e.g. https://api.example.com. No trailing slash.
- **Auth header name** (required) — e.g. Authorization or X-Api-Key.
- **Auth header value** (required) — The secret sent on every request.
- **Label** — Friendly name, e.g. My API.

## First setup

1. **Catalogue - search Custom API - Connect**.
2. Fill base URL + auth header name/value + label - **Connect** (cancel if you are only exploring).
3. Enable the Custom API tool on the agent and map the operations your contract exposes.
4. Save and prove on a test call.

## Troubleshooting

**Calls fail immediately after connect**

Remove a trailing slash from the base URL. Confirm the auth header name matches what your API expects.

## Next Steps

[Get an integration working](https://docs.voicelogica.ai/integrations/) - company connect then agent tool.  
[AI Assistants](https://docs.voicelogica.ai/integrations/mcp-settings/) - when the other system should call Voice Logica instead.