What are AI4CALL API Keys?

AI4CALL API Keys are the credentials your applications use to access the AI4CALL APIs. You create them in the portal with the New API Key button; each key is shown in plain text only once and goes in the header of your requests. You can delete keys individually, but be aware: deletion is immediate and permanent.

AI4CALL provides voice assistants that answer the phone, understand and take action. Businesses use them without writing code; developers and system integrators can connect them to their own software through complete APIs. API Keys are the entry point to those integrations: this video tutorial shows you how to generate, store and safely delete them.

How to use API Keys: request header and endpoint documentation

An API Key is a unique key your application presents in the request header of every call to the AI4CALL APIs. Full endpoint documentation is available at swagger.ai4call.com, with the parameters and formats for each call.

Two endpoints for outbound calls

Among the available endpoints, two are worth knowing from day one: they let you start outbound calls with AI4CALL assistants.

• Webhook outbound call PBX: starts outbound calls from your own PBX. The IP PBX parameter must match an address enabled under Management › Enable IP.
• Webhook outbound call: the call goes out through AI4CALL's VoIP trunks, with no configuration required on your PBX. The caller ID must be a demo or purchased number in your account.

In short, what changes is where the call starts: from your PBX, using an enabled IP address, or from AI4CALL's VoIP trunks, leaving your PBX configuration untouched.

How to generate a new API Key

In the AI4CALL portal, it takes four steps:

1. Click New API Key.
2. The Create new API Key window opens, letting you know that a new unique key will be generated.
3. Click Generate API Key.
4. Copy the key shown on screen right away and store it somewhere safe.

Storing your API Key: it is shown only once

This is the most important step: the key is shown in plain text only once. Copy it and store it safely before you close the window. After that, it appears in the table masked, along with its creation date, and can no longer be retrieved in full.

Multiple API Keys for different applications and environments

You can generate several keys and assign one to each application or environment. The benefit is practical: if a key is compromised, or you retire an integration, you delete only that key. Every integration using a different key keeps running without interruption.

How to delete an API Key safely

To delete a key, click the red icon on its row and confirm. Be careful: deletion is immediate and permanent. Every application that used that key stops working right away. That is why you should always keep track of which key is assigned to each integration.

API Key security: treat them like passwords

The final recommendation in the video tutorial is simple: treat API Keys like passwords. That means never putting a key:

• in shared source code;
• in emails or chat messages;
• in browser-side applications, where anyone could see it.

Frequently asked questions about AI4CALL API Keys

Can I retrieve an API Key after generating it?

No. The key is shown in plain text only once, when it is generated. After that it appears masked in the list and can no longer be retrieved in full. If you lose it, generate a new key and delete the old one.

What happens when I delete an API Key?

Deletion is immediate and permanent: every application that used that key stops working. Your other keys remain active.

Which endpoint do I use to call without configuring my PBX?

The Webhook outbound call endpoint: the call goes out through AI4CALL's VoIP trunks. The caller ID must be a demo or purchased number in your account.