Strava

Visão geral

O Strava é a maior rede social fitness do mundo, projetada para ciclistas, corredores e praticantes de esportes ao ar livre. A plataforma registra atividades físicas via GPS, organiza rotas e segmentos competitivos e conecta atletas em grupos e clubes. Com a integração Strava no SquadOS, seus agentes podem criar atividades manuais, consultar estatísticas do atleta, explorar segmentos e rotas, listar membros de clubes e analisar dados detalhados de desempenho como frequência cardíaca, potência e cadência.

• Site oficial: https://www.strava.com/
• Documentação na Composio: docs.composio.dev/toolkits/strava

Autenticação

Esta ferramenta utiliza OAuth 2.0 (OAUTH2) para conectar.

A Composio oferece um aplicativo gerenciado para o Strava — na maioria dos casos, você não precisa criar seu próprio app. Ao clicar em Conectar, você é direcionado para a tela de autorização do Strava onde concede as permissões necessárias.

Campo	Obrigatório	Descrição
client_id	Não	ID do cliente do app Strava (somente se usar credenciais próprias).
client_secret	Não	Segredo do cliente do app Strava (somente se usar credenciais próprias).

Como obter credenciais próprias (opcional)

Se quiser usar seu próprio app Strava em vez do app gerenciado pela Composio:

1. Acesse www.strava.com/settings/api e faça login.
2. Clique em Create & Manage Your Apps e depois em Create Application.
3. Preencha os campos obrigatórios: nome do app, site e domínio de callback.
4. No campo Callback Domain, insira exatamente: backend.composio.dev
5. Após criar o app, copie o Client ID e o Client Secret exibidos.
6. Na Composio, informe essas credenciais ao configurar a conexão.

Dica

Selecione apenas os escopos necessários para a sua integração. Para leitura de atividades e perfil público, read já é suficiente. Para atividades privadas, adicione activity:read_all. Para criar atividades, adicione activity:write.

Como conectar no SquadOS

1. Acesse Ferramentas no menu lateral (/admin/tools).
2. Abra a aba Disponíveis e procure por Strava.
3. Clique no card para abrir o modal de detalhes e em Conectar.
4. Você é levado para a página de conexão segura hospedada pela Composio, onde autoriza o acesso via OAuth 2.0 com sua conta Strava.
5. Ao concluir, você volta para o SquadOS com a conta conectada e a ferramenta disponível para os agentes. (Detalhes do fluxo em Ferramentas da Organização.)

Perguntas frequentes

Como configurar credenciais OAuth personalizadas para o Strava?

Para um guia passo a passo sobre como criar e configurar suas próprias credenciais OAuth do Strava com a Composio, consulte Como criar credenciais OAuth para o Strava.

Ações disponíveis

Criar atividade

STRAVA_CREATE_AN_ACTIVITY

Cria uma atividade manual para o atleta autenticado. Requer o escopo activity:write. Este endpoint é exclusivo para atividades inseridas manualmente. Para enviar arquivos de atividade (FIT, TCX, GPX), use a ação de upload de atividade.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
name	string	Sim	Nome/título da atividade.
sport_type	string	Sim	Tipo de esporte da atividade. Valores comuns: Run, TrailRun, Walk, Hike, Ride, MountainBikeRide, GravelRide, VirtualRide, Swim, Workout, WeightTraining, Yoga, CrossFit, Rowing, Kayaking, Skiing, Snowboarding.
start_date_local	string	Sim	Data e hora local de início da atividade no formato ISO 8601. Exemplo: 2024-01-15T09:30:00Z.
elapsed_time	integer	Sim	Tempo total decorrido da atividade em segundos. Exemplo: 3600 para 1 hora.
type	string	Não	Tipo de atividade (obsoleto). Use sport_type. Se ambos forem informados, type é ignorado.
commute	integer	Não	Defina como 1 para marcar a atividade como deslocamento. Omita ou defina como 0 para atividades comuns.
trainer	integer	Não	Defina como 1 para marcar a atividade como feita em equipamento de treino indoor. Omita ou defina como 0 para atividades ao ar livre.
distance	number	Não	Distância em metros. Exemplo: 5000.0 para 5 km.
description	string	Não	Descrição textual opcional da atividade.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Explorar segmentos

STRAVA_EXPLORE_SEGMENTS

Explora segmentos dentro de uma área geográfica delimitada. Retorna os 10 melhores segmentos que correspondem ao limite geográfico especificado e aos filtros opcionais. Segmentos são trechos de estradas ou trilhas onde atletas do Strava competem por tempos.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
bounds	string	Sim	Latitude e longitude de dois pontos que descrevem o limite retangular da busca, como string separada por vírgulas: lat_sw,lng_sw,lat_ne,lng_ne. Exemplo: 37.7,-122.5,37.8,-122.4 para a área de São Francisco.
activity_type	string	Não	Tipo de atividade desejado. Deve ser running ou riding. Padrão: riding.
min_cat	integer	Não	Categoria mínima de escalada (0–5, onde 0 é o mais fácil “NC” e 5 é o mais difícil “HC”).
max_cat	integer	Não	Categoria máxima de escalada (0–5, onde 0 é o mais fácil “NC” e 5 é o mais difícil “HC”).

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Exportar rota como GPX

STRAVA_EXPORT_ROUTE_GPX

Exporta uma rota do Strava como arquivo GPX (GPS Exchange Format). Arquivos GPX podem ser usados para importar rotas em dispositivos GPS, outros aplicativos de fitness ou softwares de mapeamento. Requer o escopo read_all para rotas privadas.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	string	Sim	Identificador único da rota Strava a exportar como GPX. Forneça como string para evitar perda de precisão numérica em IDs superiores a 2^53. Exemplo: 1234567890.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Exportar rota como TCX

STRAVA_EXPORT_ROUTE_TCX

Exporta uma rota do Strava como arquivo TCX (Training Center XML). O formato TCX é amplamente suportado por dispositivos GPS, relógios de fitness e softwares de treino como Garmin Connect e TrainingPeaks. Requer o escopo read_all para rotas privadas.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	string	Sim	Identificador único da rota Strava a exportar como TCX. Forneça como string para evitar perda de precisão numérica em IDs superiores a 2^53. Exemplo: 1234567890.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter atividade

STRAVA_GET_ACTIVITY

Recupera informações detalhadas sobre uma atividade específica pelo seu ID. Retorna um objeto DetailedActivity com dados abrangentes, incluindo distância, tempo, elevação, velocidade, frequência cardíaca, dados de potência (quando disponíveis), esforços em segmentos, voltas, divisões e mais. Requer o escopo activity:read para atividades visíveis a todos ou seguidores, e activity:read_all para atividades privadas.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	string	Sim	Identificador único da atividade a recuperar. Forneça como string para evitar perda de precisão numérica em IDs superiores a 2^53. Exemplo: 1234567890.
include_all_efforts	boolean	Não	Quando verdadeiro, inclui todos os esforços em segmentos na resposta. Quando falso ou omitido, inclui apenas os melhores esforços. Definir como verdadeiro pode aumentar significativamente o tamanho da resposta.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter streams de atividade

STRAVA_GET_ACTIVITY_STREAMS

Recupera dados de séries temporais (streams) para uma atividade específica. Os streams são os dados espaciais e de sensores brutos registrados durante uma atividade, incluindo coordenadas GPS, velocidade, frequência cardíaca, potência, etc. Requer o escopo activity:read, e activity:read_all para atividades privadas.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	integer	Sim	Identificador único da atividade. Pode ser obtido de list_athlete_activities ou get_activity.
keys	array	Sim	Lista de tipos de stream a recuperar. Tipos disponíveis: time, distance, latlng, altitude, velocity_smooth, heartrate, cadence, watts, temp, moving, grade_smooth.
key_by_type	boolean	Não	Deve ser verdadeiro. Retorna os streams indexados por tipo de stream.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter zonas da atividade

STRAVA_GET_ACTIVITY_ZONES

Retorna as zonas de frequência cardíaca e potência de uma atividade. É um recurso Summit/Premium que fornece dados de distribuição por zona, mostrando o tempo gasto em cada zona de treino. Requer assinatura Strava Summit/Premium e o escopo adequado de leitura de atividade.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	string	Sim	Identificador único da atividade. Forneça como string para evitar perda de precisão numérica em IDs superiores a 2^53. Exemplo: 1234567890.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter estatísticas do atleta

STRAVA_GET_ATHLETE_STATS

Retorna as estatísticas de atividade de um atleta, incluindo totais de ciclismo, corrida e natação para os períodos recente (últimas 4 semanas), do ano atual e de todos os tempos. Inclui apenas dados de atividades com visibilidade definida como “Todos”.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	integer	Sim	Identificador numérico do atleta. Deve corresponder ao ID do atleta autenticado, obtido via get_authenticated_athlete.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter atleta autenticado

STRAVA_GET_AUTHENTICATED_ATHLETE

Recupera o perfil do atleta Strava autenticado no momento. Retorna informações do atleta incluindo nome, localização, status da conta, fotos de perfil e conexões sociais. Com o escopo profile:read_all, retorna representação detalhada com contagem de seguidores, preferências de medição, FTP, peso e equipamentos.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter clube

STRAVA_GET_CLUB

Recupera informações detalhadas sobre um clube Strava específico pelo seu ID. Retorna detalhes abrangentes do clube incluindo nome, descrição, localização, número de membros, tipo de esporte, tipo de clube (casual, equipe de corrida, empresa, etc.), configurações de privacidade e o status de membro do atleta autenticado.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	integer	Sim	Identificador numérico único do clube Strava. Pode ser obtido via STRAVA_LIST_ATHLETE_CLUBS ou da URL do clube (ex: strava.com/clubs/1 tem id=1).

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter equipamento

STRAVA_GET_EQUIPMENT

Recupera informações detalhadas sobre um equipamento específico do atleta. Retorna detalhes completos sobre bikes ou tênis, incluindo nome, marca, modelo, distância total e status (principal/aposentado). O atleta solicitante deve ser o proprietário do equipamento.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	string	Sim	Identificador único do equipamento. IDs de bikes começam com b (ex: b12345678); IDs de tênis começam com g (ex: g12345678). Obtidos do perfil do atleta autenticado ou dos detalhes de atividade (campo gear_id).

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter rota

STRAVA_GET_ROUTE

Recupera informações detalhadas sobre uma rota Strava específica. Uma rota é um caminho planejado criado via Strava Route Builder. Retorna dados abrangentes incluindo nome, tipo de atividade, distância, ganho de elevação, coordenadas de início/fim, polyline do mapa, segmentos e waypoints. Requer o escopo read_all para rotas privadas.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	integer	Sim	Identificador numérico único da rota Strava. Pode ser obtido via list_athlete_routes ou da URL ao visualizar a rota no Strava (ex: strava.com/routes/12345678).

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter streams de rota

STRAVA_GET_ROUTE_STREAMS

Obtém dados detalhados de stream para uma rota. Retorna coordenadas GPS brutas, elevação e pontos de dados de distância ao longo do percurso de uma rota. Tipos de stream disponíveis para rotas: latlng, distance, altitude. Requer o escopo read_all para rotas privadas.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	integer	Sim	Identificador único da rota. Use list_athlete_routes para encontrar IDs de rotas do atleta autenticado.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter segmento

STRAVA_GET_SEGMENT

Recupera informações detalhadas sobre um segmento Strava específico. Um segmento é um trecho de estrada ou trilha onde atletas competem por tempos. Retorna dados abrangentes incluindo nome, tipo de atividade, distância, inclinação média e máxima, elevação, coordenadas, polyline, contagens de esforços e registros (KOM/QOM). Requer o escopo read_all para segmentos privados ou informações específicas do atleta.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	integer	Sim	Identificador numérico único do segmento Strava. Pode ser obtido via explore_segments, list_starred_segments, list_segment_efforts ou dos detalhes da atividade. Exemplo: 229781.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter esforço em segmento

STRAVA_GET_SEGMENT_EFFORT

Recupera informações detalhadas sobre um esforço em segmento específico pelo seu ID único. Um esforço em segmento representa a tentativa de um atleta em um segmento particular durante uma atividade. Retorna métricas de desempenho incluindo tempo decorrido, distância, velocidade, frequência cardíaca, potência e cadência. Requer uma assinatura ativa do Strava.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	integer	Sim	Identificador único do esforço em segmento. Pode ser obtido dos detalhes da atividade (array segment_efforts) ou do endpoint list_segment_efforts.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter streams de esforço em segmento

STRAVA_GET_SEGMENT_EFFORT_STREAMS

Retorna dados de stream para um esforço em segmento completado pelo atleta autenticado. Os streams fornecem dados brutos de série temporal associados a um esforço em segmento, como coordenadas GPS, altitude, velocidade, frequência cardíaca, potência, etc. Requer o escopo read_all.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	string	Sim	Identificador único do esforço em segmento. Forneça como string para evitar perda de precisão numérica em IDs superiores a 2^53. Exemplo: 1234567890.
keys	string	Sim	Lista separada por vírgulas dos tipos de stream a retornar. Tipos disponíveis: time, distance, latlng, altitude, velocity_smooth, heartrate, cadence, watts, temp, moving, grade_smooth. Exemplo: time,distance,altitude.
key_by_type	boolean	Não	Deve ser verdadeiro. Padrão: verdadeiro.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter streams de segmento

STRAVA_GET_SEGMENT_STREAMS

Obtém dados detalhados de stream para um segmento. Retorna dados brutos de GPS, elevação e distância ao longo do percurso de um segmento. Tipos de stream disponíveis para segmentos: distance, latlng, altitude. Requer o escopo read_all para segmentos privados.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	integer	Sim	Identificador único do segmento. Use explore_segments ou list_starred_segments para encontrar IDs de segmentos.
keys	string	Sim	Lista separada por vírgulas dos tipos de stream a retornar. Tipos disponíveis: distance, latlng, altitude. Exemplo: distance,latlng,altitude para todos os tipos de stream.
key_by_type	boolean	Não	Deve ser verdadeiro. Padrão: verdadeiro.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter status de upload

STRAVA_GET_UPLOAD

Recupera o status de um upload pelo seu ID. Use este endpoint para verificar o status de processamento de um arquivo de atividade enviado. Os uploads são processados de forma assíncrona; recomenda-se verificar no máximo uma vez por segundo até que activity_id seja preenchido ou um erro seja retornado. Requer o escopo activity:write.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
uploadId	integer	Sim	Identificador único do upload a recuperar. Este ID é retornado ao fazer upload de um arquivo de atividade via o endpoint de Upload de Atividade.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Obter zonas do atleta

STRAVA_GET_ZONES

Recupera as zonas de frequência cardíaca e potência do atleta autenticado. Retorna as zonas de treino configuradas, incluindo limites e tempo gasto em cada zona. Requer o escopo OAuth profile:read_all.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar comentários da atividade

STRAVA_LIST_ACTIVITY_COMMENTS

Recupera os comentários de uma atividade Strava específica, ordenados do mais antigo para o mais recente. Retorna detalhes do comentário incluindo texto, informações do autor e timestamps. Suporta paginação por cursor para atividades com muitos comentários.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	string	Sim	Identificador único da atividade Strava para recuperar comentários. Exemplo: 12345678987654321.
page_size	integer	Não	Número de comentários por página (1–200). Padrão: 30.
after_cursor	string	Não	Cursor para paginação. Passe o cursor de uma resposta anterior para buscar a próxima página. Omita para buscar a primeira página.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar atletas que curtiram a atividade

STRAVA_LIST_ACTIVITY_KUDOERS

Retorna os atletas que curtiram (deram kudos) em uma atividade identificada por um identificador. Requer o escopo activity:read para atividades públicas e de seguidores, e activity:read_all para atividades privadas.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	integer	Sim	Identificador único da atividade para recuperar os atletas que deram kudos.
page	integer	Não	Número da página para paginação. Padrão: 1.
per_page	integer	Não	Número de atletas por página. Padrão: 30, máximo: 200.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar voltas da atividade

STRAVA_LIST_ACTIVITY_LAPS

Recupera os dados de volta de uma atividade Strava específica. As voltas representam segmentos de uma atividade, geralmente gerados automaticamente com base em intervalos de distância, pressionamentos manuais do botão de volta ou segmentos de percurso. Cada volta contém métricas detalhadas incluindo tempo, distância, velocidade, cadência e dados de potência.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	integer	Sim	Identificador numérico único da atividade Strava. Pode ser obtido via STRAVA_LIST_ATHLETE_ACTIVITIES ou STRAVA_GET_ACTIVITY. Exemplo: 12345678901.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar atividades do atleta

STRAVA_LIST_ATHLETE_ACTIVITIES

Recupera uma lista paginada de atividades do atleta autenticado. Retorna resumos de atividades incluindo nome, tipo, distância, duração, ganho de elevação, velocidade, dados de frequência cardíaca e timestamps. Use os parâmetros before e after para filtrar por intervalo de datas.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
page	integer	Não	Número da página para paginação, começando em 1.
after	integer	Não	Timestamp Unix em segundos. Retorna apenas atividades iniciadas após este horário. Exemplo: 1704067200 para 1 de jan de 2024.
before	integer	Não	Timestamp Unix em segundos. Retorna apenas atividades iniciadas antes deste horário. Exemplo: 1704067200 para 1 de jan de 2024.
per_page	integer	Não	Número de atividades por página (1–200). Padrão: 30, máximo: 200.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar clubes do atleta

STRAVA_LIST_ATHLETE_CLUBS

Recupera uma lista paginada dos clubes Strava dos quais o atleta autenticado é membro. Retorna detalhes do clube incluindo ID, nome, localização, número de membros, tipo de esporte e imagens de perfil.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
page	integer	Não	Número da página para paginação. Começa em 1. Padrão: 1.
per_page	integer	Não	Número de clubes por página (1–200). Padrão: 30.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar rotas do atleta

STRAVA_LIST_ATHLETE_ROUTES

Lista as rotas criadas por um atleta específico. Retorna um array com resumos de rotas incluindo ID, nome, distância, ganho de elevação e tipo. Rotas privadas são filtradas, a menos que o token tenha o escopo read_all. Somente as rotas do atleta autenticado podem ser acessadas.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	integer	Sim	Identificador do atleta. Deve corresponder ao atleta autenticado para listar suas rotas.
page	integer	Não	Número da página para resultados paginados. Padrão: 1.
per_page	integer	Não	Número de rotas por página. Máximo: 200. Padrão: 30.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar atividades do clube

STRAVA_LIST_CLUB_ACTIVITIES

Recupera atividades recentes de membros de um clube específico. O atleta autenticado deve ser membro do clube solicitado para acessar este endpoint. A paginação é suportada (máximo de 200 atividades no total). Nota: as atividades do clube têm dados limitados por privacidade — não incluem IDs de atividade, datas nem nomes completos dos atletas.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	integer	Sim	Identificador único do clube. Use “Listar clubes do atleta” para obter IDs dos clubes dos quais o atleta autenticado é membro.
page	integer	Não	Número da página para paginação. Padrão: 1.
per_page	integer	Não	Número de atividades por página. Padrão: 30, máximo: 200.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar administradores do clube

STRAVA_LIST_CLUB_ADMINISTRATORS

Retorna uma lista dos administradores de um clube Strava. A resposta inclui o primeiro nome, sobrenome (possivelmente abreviado) e estado de cada administrador. Para clubes públicos, este endpoint é acessível sem associação. Para clubes privados, o usuário autenticado pode precisar ser membro.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	integer	Sim	Identificador único do clube Strava. Pode ser obtido via STRAVA_LIST_ATHLETE_CLUBS ou STRAVA_GET_CLUB.
page	integer	Não	Número da página para paginação (começa em 1). Padrão: 1.
per_page	integer	Não	Número de administradores por página. Padrão: 30, máximo: 200.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar membros do clube

STRAVA_LIST_CLUB_MEMBERS

Retorna uma lista dos atletas que são membros de um clube. O atleta autenticado deve pertencer ao clube solicitado para acessar este endpoint. Os resultados são paginados. Nota: devido às configurações de privacidade, algumas informações dos membros podem ser limitadas.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	integer	Sim	Identificador único do clube. Use STRAVA_LIST_ATHLETE_CLUBS para obter IDs ou STRAVA_GET_CLUB para verificar um ID de clube.
page	integer	Não	Número da página para paginação. Padrão: 1.
per_page	integer	Não	Número de membros por página. Padrão: 30, máximo: 200.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar esforços em segmento

STRAVA_LIST_SEGMENT_EFFORTS

Lista os esforços do atleta autenticado em um segmento específico. Retorna todos os esforços no segmento, opcionalmente filtrados por intervalo de datas. Inclui detalhes como tempo decorrido, tempo em movimento, data de início, distância, potência média, frequência cardíaca média, ranking pessoal e ranking de KOM/QOM (se estiver entre os 10 melhores).

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
segment_id	integer	Sim	Identificador único do segmento. Pode ser obtido via explore_segments, get_activity (que inclui segment_efforts) ou endpoints de segmentos marcados com estrela.
per_page	integer	Não	Número de itens por página (1–200). Padrão: 30.
start_date_local	string	Não	Filtra esforços iniciados após esta data no formato ISO 8601. Exemplo: 2023-01-01T00:00:00Z.
end_date_local	string	Não	Filtra esforços terminados antes desta data no formato ISO 8601. Exemplo: 2023-12-31T23:59:59Z.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Listar segmentos favoritos

STRAVA_LIST_STARRED_SEGMENTS

Retorna uma lista dos segmentos marcados com estrela pelo atleta autenticado, com detalhes resumidos incluindo nome, distância, elevação, inclinação e localização. Segmentos privados são filtrados, a menos que o token tenha o escopo read_all.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
page	integer	Não	Número da página para resultados paginados. Começa em 1. Padrão: 1.
per_page	integer	Não	Número de segmentos por página. Máximo: 200. Padrão: 30.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Marcar segmento com estrela

STRAVA_STAR_SEGMENT

Adiciona ou remove a estrela (favorito) de um segmento para o atleta autenticado. Requer o escopo profile:write.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
id	integer	Sim	Identificador único do segmento Strava a marcar ou desmarcar com estrela. Pode ser obtido via explore_segments ou get_segment.
starred	boolean	Não	Se verdadeiro, adiciona estrela ao segmento; se falso, remove a estrela.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Atualizar atleta

STRAVA_UPDATE_ATHLETE

Atualiza o perfil do atleta autenticado. Atualmente suporta apenas a atualização do peso do atleta. Requer o escopo profile:write.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
weight	number	Sim	Peso do atleta em quilogramas. Deve ser um número positivo (ex: 70.5).

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Fazer upload de atividade

STRAVA_UPLOAD_ACTIVITY

Faz upload de um novo arquivo de atividade (FIT, TCX ou GPX) para criar uma atividade no Strava. O upload é processado de forma assíncrona. Este endpoint retorna imediatamente um ID de upload, que pode ser usado com o endpoint de status de upload para verificar o processamento e recuperar o ID da atividade criada. Os arquivos devem ter no máximo 25 MB e conter dados reais de treino com timestamps em cada ponto de rastreamento. Requer o escopo OAuth activity:write.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
file	object	Sim	Arquivo de atividade a fazer upload. Formatos suportados: FIT, TCX, GPX (e suas variantes gzipadas). Os arquivos devem conter timestamps em cada ponto de rastreamento. Tamanho máximo: 25 MB.
data_type	string	Sim	Formato do arquivo enviado. Deve corresponder ao formato real do arquivo. Opções: fit, fit.gz, tcx, tcx.gz, gpx, gpx.gz.
name	string	Não	Nome da atividade a exibir no Strava. Se não informado, o Strava gerará um nome automaticamente com base no tipo de atividade e horário.
sport_type	string	Não	Tipo de esporte a atribuir à atividade enviada.
description	string	Não	Descrição textual da atividade.
commute	boolean	Não	Defina como verdadeiro para marcar como atividade de deslocamento.
trainer	boolean	Não	Defina como verdadeiro para marcar como atividade em equipamento de treino indoor.
external_id	string	Não	Identificador único arbitrário para este upload. Útil para rastrear uploads de sistemas externos e evitar uploads duplicados.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.