> ## Documentation Index
> Fetch the complete documentation index at: https://docs.open.cx/llms.txt
> Use this file to discover all available pages before exploring further.

# Aircall connect

> Generate an Aircall API ID and token from the Aircall dashboard and hand both to the Post Call Context workflow action.

OpenCX workflows authenticate to Aircall with an <Tooltip tip="A pair of credentials (API ID + API token) generated from the Aircall dashboard. Sent as HTTP Basic auth on every request.">API key</Tooltip> — an **API ID** and an **API token** used together. Both travel into the workflow action as inputs — there is no org-level connect screen today.

## Generate credentials

<Steps>
  <Step title="Open the Aircall API keys page">
    Sign in to your Aircall dashboard as an admin and open [**Integrations → API Keys**](https://dashboard.aircall.io/view-api-keys).
  </Step>

  <Step title="Create an API key">
    Click **Add an API key**. Aircall shows you two values: the **API ID** and the **API token**.

    <Warning>
      Anyone with the pair can read and write your Aircall data — calls, contacts, users. Treat it like a password, and note that Aircall shows the token only once at creation time.
    </Warning>
  </Step>

  <Step title="Store both somewhere safe">
    Drop both into your password manager or secret store. Every workflow node that touches Aircall expects them as inputs, so you will reuse them across flows.
  </Step>
</Steps>

<Info>
  OpenCX does not persist Aircall credentials at the organization level yet. Each workflow action reads the API ID and token from its own configuration — rotating the key means updating every workflow that uses it.
</Info>

## Verify the connection

Aircall exposes a ping endpoint that answers with `{"ping": "pong"}` when the credentials are valid:

```bash theme={"dark"}
curl https://YOUR_API_ID:YOUR_API_TOKEN@api.aircall.io/v1/ping
```

A `403 Forbidden` response means the ID/token pair is wrong or was revoked — regenerate the key from the [API Keys page](https://dashboard.aircall.io/view-api-keys).

***

## Related Documentation

<CardGroup cols={2}>
  <Card title="Post Call Context Action" icon="phone-forwarded" href="/integrations/aircall/post-call-context-action">
    Full reference for the workflow action.
  </Card>

  <Card title="Overview" icon="phone" href="/integrations/aircall/overview">
    What the Aircall integration does at a glance.
  </Card>

  <Card title="Troubleshooting" icon="wrench" href="/integrations/aircall/troubleshooting">
    Credentials rejected, call not found, comment limits.
  </Card>

  <Card title="AI Phone agent configuration" icon="gear" href="/phone/agent-config">
    Set up the transfer destination that forwards to Aircall.
  </Card>
</CardGroup>