> For the complete documentation index, see [llms.txt](https://twentytwo.documentationai.com/llms.txt).
> Use it to discover all available pages before exploring further.

# API & Webhooks

# API & Webhooks

Connect Twenty2 with your CRM, internal tools, or other applications to automate workflows and exchange data. Navigate to **Profile → Integrations → Build with Twenty2 API** to get started.

---

## API Keys

API keys allow your applications to securely interact with the Twenty2 API.

Each key includes:

- **Name** – For your reference

- **API Key** – Used to authenticate requests

- **API Secret** – Used alongside the API Key for secure access

API Keys and Secrets are masked by default and can be revealed or copied when needed.

To create a new key, click **Create New**, enter a name, and generate your credentials. The API Key and Secret are shown once during creation, so be sure to store them securely.

You can create multiple API keys, making it easy to manage different integrations independently. Keys can be revoked or deleted at any time without affecting your other integrations.

Check full API documentation here: [API reference](/api-reference/quick-start).

---

## Webhooks

Webhooks push event notifications like a call completing — to a URL on your own server, so your systems can react without polling Twenty2 for updates.

Each webhook is listed with its Callback URL and creation date. To add one, provide the destination URL and your authentication details, and Twenty2 starts sending notifications to it as the relevant events occur.

---

## Using the API

<Columns cols="2">
  <Card title="Initiate a Call" href="/api-reference/initiate-call" icon="lucide-phone-call" horizontal="false" target="_self">
    Trigger outbound calls via API.
  </Card>

  <Card title="List Calls" href="/api-reference/list-calls" icon="list" horizontal="false">
    Retrieve call history for your workspace.
  </Card>

  <Card title="Get Call Detail" href="/api-reference/get-call-details" icon="layout-list-icon" horizontal="false" target="_self">
    Fetch full details for a specific call.
  </Card>

  <Card title="Authentication" href="/getting-started/authentication" icon="key" horizontal="false">
    How to authenticate your API requests.
  </Card>
</Columns>

