OAuth do Cal.com

Adicione Cal.com ao seu app

Um botão conecta as contas Cal.com dos seus usuários. Depois, seu app lê a disponibilidade deles e agenda em nome deles pela API v2, apenas com os escopos que eles permitirem. Já criou? Liste na App Store do Cal.com.

Usado por empresas em rápido crescimento no mundo todo

Continuar com Cal.com

Os botões oficiais, servidos por app.cal.com. Confira cada um em fundo claro ou escuro, copie como HTML, React, Markdown ou URL e insira seu ID de cliente e URI de redirecionamento.

Background
Copy as
  • Continue with Cal.com, dark, rounded
    Dark, rounded
  • Continue with Cal.com, light, rounded
    Light, rounded
  • Continue with Cal.com, neutral, rounded
    Neutral, rounded
  • Continue with Cal.com, dark, squared
    Dark, squared
  • Continue with Cal.com, light, squared
    Light, squared
  • Continue with Cal.com, neutral, squared
    Neutral, squared
  • Continue with Cal.com, coss ui
    coss ui

Do botão ao agendamento

OAuth 2.0 padrão com o fluxo de código de autorização. O botão leva as pessoas para Cal.com, elas escolhem o que seu app pode fazer, e você troca o código por tokens.

  • Clientes confidenciais mantêm um segredo no servidor; clientes públicos usam PKCE (S256).
  • Tokens de acesso duram 30 minutos; tokens de atualização geram novos tokens.
  • Até 10 URIs de redirecionamento exatas por cliente, sem curingas.
  • Um token chama apenas os endpoints cobertos pelos seus escopos.

Envie as pessoas para Cal.com

O link do botão. Cal.com mostra a tela de consentimento e redireciona de volta com um código.

1GET https://app.cal.com/auth/oauth2/authorize2  ?client_id=YOUR_CLIENT_ID3  &redirect_uri=https://your-app.com/callback4  &state=YOUR_STATE5  &scope=BOOKING_READ%20BOOKING_WRITE67# de volta ao seu lado8https://your-app.com/callback?code=AUTHORIZATION_CODE&state=YOUR_STATE

Três passos até a App Store

O cliente OAuth conecta seu app às contas das pessoas. A listagem na App Store é como os usuários do Cal.com o encontram.

01

Crie um cliente OAuth

Em Configurações → Desenvolvedor → OAuth, dê um nome ao seu app, escolha pelo menos um escopo e adicione suas URIs de redirecionamento. O cliente começa como pendente; Cal.com o analisa e envia um e-mail para você quando for aprovado.

02

Adicione o botão

Coloque um botão Continuar com Cal.com onde seus usuários conectam ferramentas. Ele abre a tela de consentimento do Cal.com, e seu callback troca o código por tokens.

03

Liste na App Store

Cal.com é de código aberto: crie a listagem do seu app em packages/app-store com yarn create-app, depois abra um pull request em calcom/cal.com. O guia mostra o passo a passo.

Peça apenas o que seu app precisa

As pessoas veem todos os escopos na tela de consentimento antes de permitir, e um token só pode acessar os endpoints cobertos pelos seus escopos.

01

Usuário

A própria conta de uma pessoa: BOOKING_*, EVENT_TYPE_*, SCHEDULE_*, APPS_*, PROFILE_*, WEBHOOK_* e INSIGHTS_READ.

02

Equipe

As equipes às quais pertencem, com os escopos TEAM_*: links de agendamento de equipe, reservas, agendas e associações.

03

Organização

Acesso em toda a organização com os escopos ORG_*. Cada um também concede o escopo TEAM_* correspondente.

Você precisa de agendamento com marca própria dentro do seu app?

Use o coss.com Scheduling, criado pela equipe da Cal.com. A infraestrutura que viabiliza milhões de reservas, com a sua marca e para seus próprios usuários.

coss.scheduling.bookings.create()

const result = await coss.scheduling.bookings.create({
  event_type: eventTypeId,
  start: "2026-03-10T14:00:00Z",
  attendee: {
    uid: "customer_77",
    name: "Sam Lee",
    email: "[email protected]",
    time_zone: "America/New_York",
  },
});
if (result.error?.code === "slot_unavailable") {
  // Someone got there first: show the times again.
}

Trial lesson with Ana Reyes

30 minutes, 10 minute buffer

confirmed
Ana Reyes's week: open times, times busy on a connected calendar, and bookings
TimeMon 9Tue 10Wed 11Thu 12Fri 13
09:00busyopenbookedopenopen
10:00openSamopenbusyopen
11:00openopenbusyopenopen
13:00bookedopenopenbookedopen
14:00openbusyopenbookedopen
15:00openbusyopenopenbusy
OpenBusy on calendarBooked
  1. confirmedCalendar invitations to Sam and Ana
  2. scheduling.booking.confirmed

Dúvidas sobre desenvolver com a Cal.com

As respostas curtas estão aqui. Para qualquer outra coisa, pergunte abaixo.

Faça uma pergunta

Conecte seu app à Cal.com

Crie um cliente OAuth, adicione o botão e coloque seu app na frente de todos os usuários da Cal.com.

Criar um cliente OAuthLer a documentação do OAuth