mirror of
https://github.com/twentyhq/twenty
synced 2026-04-21 13:37:22 +00:00
f740bac988
Co-authored-by: Félix Malfait <felix.malfait@gmail.com> Co-authored-by: Félix Malfait <felix@twenty.com>
81 lines
3 KiB
Text
81 lines
3 KiB
Text
---
|
|
title: API Keys & Webhooks
|
|
info: "Create and manage API keys for authentication and set up webhooks for real-time notifications."
|
|
image: /images/user-guide/api/api.png
|
|
sectionInfo: Learn how to connect Twenty to your other tools.
|
|
---
|
|
|
|
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
|
|
|
|
<Frame>
|
|
<img src="/images/user-guide/api/api.png" alt="Header" />
|
|
</Frame>
|
|
|
|
## API Keys
|
|
|
|
API keys allow automated access to your CRM data, synchronize data with other systems, and create custom integrations or solutions.
|
|
|
|
### Create an API Key
|
|
|
|
1. Go to **Settings → APIs & Webhooks**
|
|
2. Click **+ Create key** at the top right
|
|
3. Configure your API key:
|
|
- **Name**: Give your API key a descriptive name
|
|
- **Expiration Date**: Set when the key should expire
|
|
4. Click **Save** to generate your API key
|
|
5. **Important**: Copy and store your API key immediately, it's only shown once
|
|
|
|
Once created, your API key provides access to your custom API documentation and playground where you can test endpoints with your actual data model.
|
|
|
|
<Warning>
|
|
Since your API key gives access to sensitive information, you shouldn't share it with services you don't fully trust. If leaked, someone can use it maliciously. If your API key's security is compromised, immediately disable it and generate a new one.
|
|
</Warning>
|
|
<VimeoEmbed videoId="928786722" title="Creating API key" />
|
|
|
|
|
|
### Manage API Keys
|
|
|
|
**Regenerate an API Key:**
|
|
1. Go to **Settings → APIs & Webhooks**
|
|
2. Click on the API key you want to regenerate
|
|
3. Click the **Regenerate** button
|
|
4. Copy and store the new API key immediately
|
|
|
|
**Delete an API Key:**
|
|
1. Find the API key in your list
|
|
2. Click on the key to open its details
|
|
3. Click **Delete** to remove it permanently
|
|
|
|
## Webhooks
|
|
|
|
Webhooks allow for immediate updates to your specified URL about changes or events related to your customer data.
|
|
|
|
For example, when an Opportunity moves to "Closed Won", a webhook can automatically trigger invoice creation in your accounting system. Note that this type of automation can also be achieved using Twenty's in-app [Workflows feature](/user-guide/workflows/getting-started-workflows), which offers triggers based on field updates for internal automation.
|
|
|
|
Webhooks are ideal for integrating with external systems, while Workflows support both internal automation and external tool connections via webhook triggers, code nodes, and HTTP nodes.
|
|
|
|
### Create a Webhook
|
|
|
|
1. Go to **Settings → APIs & Webhooks → Webhooks**
|
|
2. Click **+ Create webhook**
|
|
3. Enter your webhook URL (where you want to receive notifications)
|
|
4. Click **Save**
|
|
|
|
Your webhook will immediately start receiving real-time notifications about changes to your CRM data.
|
|
|
|
<VimeoEmbed videoId="928786708" title="Video demonstration" />
|
|
|
|
### Manage Webhooks
|
|
|
|
**Delete a Webhook:**
|
|
1. Go to **Settings → APIs & Webhooks → Webhooks**
|
|
2. Find the webhook you want to remove
|
|
3. Click on the webhook
|
|
4. Click **Delete** and confirm in the popup
|
|
|
|
**Edit a Webhook:**
|
|
1. Click on the webhook you want to modify
|
|
2. Update the URL or other settings
|
|
3. Click **Save** to apply changes
|
|
|
|
|