YOGO API

Os seus dados,
nos seus termos.

O servidor YOGO MCP liga o seu estúdio diretamente ao Claude Desktop, Claude Code e Gemini — pergunte em linguagem natural, obtenha respostas em segundos. Ou use a API REST subjacente para construir as suas próprias integrações com CRM, BI ou app de colaboradores.

Ver documentação Contacte-nos para obter acesso
REST & JSON Pronto para MCP Alojado na UE
first-call.sh 
# Pergunta no Claude com YOGO MCP
> Quantos clientes se inscreveram
  no mês passado?

# O Claude chama o tool MCP:
list_customers(auto_paginate: true)

< 147 novos clientes em abril — 23%
  mais que em março. Quer um resumo?
# Primeira chamada — obter os seus clientes
curl https://api.yogobooking.com/customers \
  -H "X-API-KEY: your_api_key_here"
// Primeira chamada — obter os seus clientes
const res = await fetch(
  'https://api.yogobooking.com/customers',
  { headers: { 'X-API-KEY': process.env.YOGO_KEY } }
);

const { data, hasMore, next } = await res.json();
Integrações reais

Exemplos que pode construir esta semana.

Isto não é teoria. É exatamente para isto que a YOGO API foi desenhada. Cada integração leva alguns dias de trabalho a um programador — e poupa-lhe trabalho manual durante toda a vida do estúdio.

Planeamento de turnos

Sincronize aulas como turnos no Planday, Tamigo ou Sameworks.

Extraia o horário de aulas do YOGO e crie turnos automaticamente no seu sistema de planeamento. O professor vê as suas aulas YOGO como turnos a sério, ao lado do resto da equipa — e a exportação salarial corresponde ao que foi efetivamente lecionado.

GET /classes GET /teachers nightly sync 
// Diário: criar turnos no Planday
const classes = await paginate(
  `${YOGO}/classes?from=today&to=+14d`
);

for (const c of classes) {
  for (const teacherId of c.teacherIds) {
    await planday.shifts.create({
      employeeId: mapTeacher(teacherId),
      departmentId: DEPT,
      startDateTime: c.startsAt,
      endDateTime: c.endsAt
    });
  }
}
Troca de professor no Claude

Reatribua professores a partir de um chat — sem abrir o painel admin.

Pergunte ao Claude em linguagem natural. Ele encontra a aula e o professor através de list_classes e list_teachers, e depois executa set_class_teachers. Cada escrita fica registada no log de auditoria e pode ser consultada via list_write_logs.

list_classes list_teachers set_class_teachers list_write_logs 
# Exemplo de prompt no Claude Desktop
> Põe a Mette no Vinyasa de quinta às 07:00.

# O Claude encontra aula e professor:
list_classes({ from: "2026-05-14", to: "2026-05-14" })
list_teachers({ search: "Mette" })

# Escreve a alteração:
set_class_teachers({
  classId: 12345,
  teacherIds: [678]
})

# Log de auditoria:
list_write_logs({ entityType: "class.teachers" })
CRM & e-mail

Sincronize membros no HubSpot, Mailchimp ou Klaviyo.

Corra um job noturno que extrai todos os clientes com o seu histórico de reservas e os envia para a sua plataforma de marketing. Segmente com base em comportamento real — ativos, em quebra, recém-inscritos — e envie campanhas relevantes.

GET /customers GET /bookings cursor pagination 
# Noturno: sincronizar clientes para Mailchimp
let cursor;
do {
  const res = await fetch(
    `${YOGO}/customers?after=${cursor || ''}`,
    { headers: { 'X-API-KEY': KEY } }
  ).then(r => r.json());

  await mailchimp.lists.batchSubscribe(
    LIST_ID,
    res.data.map(toMailchimpMember)
  );

  cursor = res.hasMore ? extractAfter(res.next) : null;
} while (cursor);
BI & relatórios

Dashboard em tempo real no Power BI ou Looker Studio.

Extraia reservas e o horário de aulas para a sua stack de BI — combinados com dados financeiros do seu sistema de contabilidade, dados de fitness do Strava, ou o que mais utilize. Finalmente, um relatório de gestão completo.

GET /classes GET /bookings GET /customers 
# ETL diário → dataset Power BI
const bookings = await paginate(
  `${YOGO}/bookings?from=${yesterday}`
);

// Bookings + class expansion (requer expand=class)
const bookings = await paginate(
  `${YOGO}/bookings?from=yesterday&to=today&expand=class`
);

const rows = bookings.map(b => ({
  date: b.class.startsAt,
  className: b.class.className,
  status: b.cancelledAt ? 'cancelled'
        : b.checkedInAt ? 'checked-in'
        : 'booked',
  customerId: b.customerId
}));

await powerbi.pushRows(DATASET, rows);
App de colaboradores

Envie professores e aulas para a sua app de colaboradores com a sua marca.

Sincronize o horário de aulas e os dados dos professores para a sua app de colaboradores — por exemplo Monotree — para que a equipa tenha os turnos do dia, contactos e detalhes das aulas no bolso, juntamente com onboarding e comunicação interna. Uma app, uma fonte única de verdade.

GET /classes GET /teachers nightly sync 
// Push diário para Monotree
const classes = await paginate(
  `${YOGO}/classes?from=today&to=+14d&expand=classType,room`
);

const shifts = classes.map(c => ({
  date: c.startsAt,
  title: c.classType.name,
  teacherIds: c.teacherIds,
  room: c.room.name
}));

await monotree.shifts.upsert(shifts);
KK
Inspiração · Open source

O Kristian construiu uma integração sGTM — e tornou-a open source.

Kristian Krogh Bang construiu uma pipeline open source que consulta /orders, /bookings e /customers a cada 60 segundos e envia os dados para o GTM server-side — e daí para o GA4, Meta CAPI, Klaviyo ou outros. Todo o projeto está sob licença Apache 2.0 no GitHub. Uma boa referência se quiser construir algo semelhante.

GitHub Ler o artigo LinkedIn
Pronto para IA · MCP

Todo o seu estúdio.
Num único chat.

O servidor YOGO MCP funciona em mcp.yogobooking.com/mcp e expõe cada endpoint REST como um tool MCP. Ligue-o ao Claude Desktop, Claude Code ou Gemini com a sua chave API existente — mesma autenticação, mesmo log de auditoria. Sem código de cola, sem servidores para gerir.

yogo-mcp · ligado
L
Você
Que aulas estão no horário para a próxima semana?
C
Claude
Vou consultar o horário.
tool_calllist_classes(from: "2026-05-11", expand: "teachers")
C
Claude
Tem 24 aulas para a próxima semana. A aula de Vinyasa de quinta às 07:00 não tem professor atribuído — quer que coloque a Mette?

Todo o estúdio como tools

Clientes, professores, encomendas, reservas, aulas — cada endpoint REST está exposto como um tool MCP. Inclui set_class_teachers para reatribuir professores diretamente a partir do chat.

Mesma chave API, mesmas regras

O servidor MCP usa a sua chave API existente como bearer token. Mesmo plan gating e mesmo log de auditoria via list_write_logs.

Ligado em 5 minutos

Claude Desktop, Claude Code e Gemini são suportados. Adicione o servidor com um comando CLI ou ficheiro de configuração — sem necessidade de código.

ChatGPT e Claude.ai web ainda não são suportados — requerem OAuth 2.1, no qual estamos a trabalhar. Use Claude Desktop ou Claude Code entretanto.
Preço

Um preço fixo. Tudo incluído.

O acesso à API é um add-on aos planos Studio e Studio+App.

79€ / mês

Requer um plano Studio ou Studio+App ativo.

  • Documentação pública completa
  • Acesso a todos os endpoints existentes
  • Novos endpoints à medida que são lançados — sem custo adicional
  • Alojado na UE, compatível com RGPD

As letras pequenas

Disponibilizamos documentação API abrangente, mas não oferecemos suporte ao processo de integração em si. Isto significa que precisa de ter capacidade interna para construir e manter a sua integração. Naturalmente, garantimos que a API é continuamente mantida e atualizada do nosso lado. Se tiver dúvidas sobre o funcionamento da API, não hesite em contactar-nos.

Perguntas e respostas

As dúvidas que mais nos colocam.

O que é a YOGO API?

A YOGO API é uma API REST oficial para a plataforma YOGO Booking. Permite a estúdios de yoga, ginásios e empresas de wellness extrair os seus próprios dados — clientes, encomendas, reservas, aulas, professores — e construir integrações com CRM, e-mail marketing, BI, planeamento de turnos e apps para colaboradores.

Quanto custa a YOGO API?

O acesso à API custa 79€ por mês e é um add-on aos planos Studio e Studio+App da YOGO. O preço inclui acesso a todos os endpoints existentes, ao servidor MCP e a futuros endpoints sem custo adicional. A documentação pública completa está disponível gratuitamente em docs.api.yogobooking.com.

O que é o servidor YOGO MCP?

O servidor YOGO MCP é um servidor Model Context Protocol que expõe os endpoints REST da YOGO como tools diretamente no Claude Desktop, Claude Code e Gemini. Funciona em mcp.yogobooking.com/mcp, usa a sua chave API existente como bearer token, e partilha o mesmo log de auditoria que a API REST. A ligação demora 5 minutos e não requer código.

Que integrações posso construir com a YOGO API?

Integrações típicas incluem: sincronização de dados de clientes para CRM (HubSpot, Klaviyo, Mailchimp), dashboards em tempo real em ferramentas de BI (Power BI, Looker Studio, BigQuery), planeamento de turnos em que os professores aparecem como turnos (Planday, Tamigo, Sameworks), apps para colaboradores com a marca do estúdio e as aulas do dia (por exemplo Monotree), widgets de reserva personalizados no seu próprio site (Squarespace, Webflow, Next.js), e tracking analítico server-side (sGTM → GA4, Meta CAPI). Um programador consegue tipicamente construir uma integração standard em poucos dias de trabalho.

A YOGO oferece suporte ao processo de integração?

Não. Disponibilizamos documentação API abrangente, mas não oferecemos suporte ao processo de integração em si. Isto significa que precisa de ter capacidade interna para construir e manter a sua integração, ou contratar um programador externo. Naturalmente, garantimos que a API é continuamente mantida e atualizada do nosso lado, e pode contactar-nos com questões sobre a funcionalidade da API.

Que planos YOGO têm acesso à API?

O acesso à API está disponível como add-on aos planos YOGO Studio e Studio+App. Precisa de ter um plano Studio ou Studio+App ativo, e depois ativar o acesso à API por 79€/mês.

A YOGO API é compatível com o RGPD?

Sim. A YOGO API é alojada na UE e cumpre o RGPD. Mantém o controlo total sobre os seus próprios dados — a API apenas expõe dados do seu próprio estúdio através de uma chave API ligada à sua conta.

Pronto para construir?

Comece pela documentação.

A documentação completa e atualizada está publicamente disponível. Contacte-nos quando estiver pronto para ativar o acesso à API na sua conta.

Abrir documentação Pedir acesso