Get API key for Team/ connect team to retell AI

[moritzschoelderle]

Hello, I want to use a cal.com integration in Retell AI, to check the calendars of multiple team members. For that I need to connect the team and the event within the team to Retell, which usually works with an API key and an event ID. I have the event ID, but I don´t know what API key to use. If I use the key from my Team-Owner Account, it doesn´t work, so I figured there has to be an API key specifically for the team somewhere. Could you please tell me how exactly I should handle this situation.

[dosubot[bot]]

Hi @moritzschoelderle! I'm Dosu and I’m helping the cal.com team.

To connect your Cal.com team to Retell AI and access multiple team members' calendars, you need a team-scoped API key. Cal.com supports API keys that are associated with a specific team by specifying the team during API key creation—using a personal (even team-owner) API key will not work for team-level access.

A privileged user (like an admin or owner) must create a new API key and select the relevant team during the process. This is not automatic; you need to generate it from within Cal.com’s API key management, making sure to set the correct team and permissions. When using this key, set the Authorization header as Bearer cal_<YOUR_API_KEY> in your integration setup with Retell AI. Make sure the key has the necessary scopes to access the team resources you need. There are no special requirements for Retell AI—the generic Cal.com API key and permissions model applies here as with other integrations [source] [source].

If you don’t see the option to create a team API key, check your permissions or ask a team admin to do it.

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}   

[moritzschoelderle]

When I create a new API key on my owner account I can only change the name and the date when it expires. I can´t select a team.

[moritzschoelderle]

@dosu when I create a new api key on my team owner account I can only change the name and the expiration date, I can´t select a team.

[moritzschoelderle]

@dosu how can I manage this

[dosubot[bot]]

You can't currently create a team-scoped API key from the Cal.com web UI—even as a team owner—because the UI doesn't expose the option to select a team. However, the backend API does support creating API keys for a specific team by including a teamId in the request payload. This means you would need to use the API directly (for example, via a script, Postman, or a custom admin tool) to generate a team-scoped API key that works for integrations like Retell AI.

If you have access to Cal.com's API, you can call the API key creation endpoint and include the teamId field in your request body. The relevant backend logic is documented in the codebase and expects a payload like:

{
  "note": "Retell AI integration",
  "apiKeyDaysValid": 30,
  "teamId": <your_team_id>
}

This will generate an API key scoped to your team, which you can then use for your integration. The UI limitation is a known gap and not addressed in recent updates or pull requests.
Reference: API key creation with teamId
Reference: CreateApiKeyInput with teamId

Let me know if you need help with the exact API call or example request!

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}