hyype.com.br/docs/api

Partner API

Integre seu sistema com a Hyype: produtos, ofertas, conteúdos, vendas, leads e checkout — tudo do seu negócio, com um token.

Começar em 4 passos

A Partner API permite que outro sistema (ERP, CRM, automação ou agente de IA) leia e gerencie dados do seu negócio na Hyype, sem usar o painel manualmente.

  1. Entre no painel da Hyype com a conta do produtor (dono do negócio).
  2. Abra Configurações e vá até a seção Chaves de API / Partner API.
  3. Crie uma chave, copie o token e guarde com segurança — ele só aparece na criação.
  4. Cole o token no campo abaixo (ou use no seu sistema) e comece pelas rotas de Produtos → Ofertas → Entregáveis.

Onde obter o token: app.hyype.com.br/settings → Chaves de API

Como produto, oferta e conteúdo se relacionam

Na Hyype, vender algo digital não é um único cadastro. São peças que se ligam. Pense assim:

1. Produto

É o “pacote” que você vende — o nome e a identidade do que o cliente compra (ex.: Curso de Marketing).

2. Oferta

É a forma de vender o produto: preço, recorrência, status. Um produto pode ter várias ofertas (à vista, mensal, promoção).

3. Conteúdo (entregável)

É o que o comprador recebe de fato: curso, ebook, comunidade, etc. O conteúdo se vincula ao produto para liberar o acesso após a compra.

Ordem recomendada

Crie o produto → crie a oferta ligada a esse produto (informando o produto) → crie o conteúdo. A oferta sempre depende de um produto; o conteúdo precisa ficar associado a ele para o comprador receber o acesso (no painel do produto, se ainda não vinculou pela API).

Exemplo: produto “Mentoria VIP” → oferta “R$ 997 à vista” ligada a esse produto → entregável “Área de membros”. Afiliados, checkout e vendas usam essa mesma base.

Autenticação

Em toda requisição, envie o header Authorization com o token. O negócio (domínio) é identificado automaticamente pelo token — você não precisa informar o domínio na URL.

  • Formato: Authorization: Bearer SEU_TOKEN
  • Cada token vale só para o negócio em que foi criado.
  • Usuários compradores não são criados pela API — eles entram pela compra/checkout. Aqui você consulta e atualiza quem já existe no seu domínio.

Usar com IA (MCP)

O MCP (Model Context Protocol) permite que ferramentas como Cursor ou Claude usem a Partner API por meio de “ferramentas” prontas — listar vendas, criar produto, consultar leads — sem você montar cada chamada HTTP na mão.

Há um servidor MCP oficial da Hyype que espelha esta API. Você configura uma vez o token e o agente passa a operar no seu negócio.

  1. Tenha o token da Partner API (mesmo do painel).
  2. No projeto, use o servidor em apps/mcp-partner-api (Node).
  3. No Cursor (ou cliente MCP), adicione a configuração abaixo com seu token e reinicie o agente.
{
  "mcpServers": {
    "hyype-partner-api": {
      "command": "node",
      "args": ["./apps/mcp-partner-api/server.js"],
      "env": {
        "HYYPE_PARTNER_API_URL": "https://api.hyype.com.br/api/v1",
        "HYYPE_PARTNER_API_TOKEN": "seu-token-aqui"
      }
    }
  }
}

Com o MCP ativo, o agente pode chamar ações como consultar o contexto do token, listar/criar produtos e ofertas, gerenciar entregáveis, afiliados, leads, vendas e checkout — sempre limitado ao seu negócio.

Contexto

GET/me

Contexto do token

Retorna o domínio/negócio vinculado ao token, o usuário técnico da API e metadados do token atual.

Exemplos de código

curl -X GET 'https://api.hyype.com.br/api/v1/me' \
  -H 'Authorization: Bearer SEU_TOKEN_AQUI' \
  -H 'Accept: application/json' \

Usuários

GET/users

Listar usuários

Lista usuários do seu domínio. Filtros: search, role e paginação.

Parâmetros

Exemplos de código

curl -X GET 'https://api.hyype.com.br/api/v1/users?role=member&per_page=25&page=1' \
  -H 'Authorization: Bearer SEU_TOKEN_AQUI' \
  -H 'Accept: application/json' \
GET/users/{id}

Obter usuário

Detalhe de um usuário do seu domínio.

Parâmetros

Exemplos de código

curl -X GET 'https://api.hyype.com.br/api/v1/users/1' \
  -H 'Authorization: Bearer SEU_TOKEN_AQUI' \
  -H 'Accept: application/json' \
PATCH/users/{id}

Atualizar usuário

Edita nome, e-mail, telefone e preferências de notificação. Não altera o usuário técnico da API.

Parâmetros

Body (JSON)

CampoTipoValores permitidos
namestringtexto livre
emailstringtexto livre
phonestringtexto livre
notify_by_emailbooleantrue, false
notify_by_whatsappbooleantrue, false
notify_by_pushbooleantrue, false

Exemplos de código

curl -X PATCH 'https://api.hyype.com.br/api/v1/users/1' \
  -H 'Authorization: Bearer SEU_TOKEN_AQUI' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "Nome Atualizado",
  "phone": "11999999999",
  "notify_by_email": true
}'
DELETE/users/{id}

Arquivar usuário

Arquiva o usuário. Administradores do negócio e o usuário técnico da API não podem ser removidos.

Parâmetros

Exemplos de código

curl -X DELETE 'https://api.hyype.com.br/api/v1/users/1' \
  -H 'Authorization: Bearer SEU_TOKEN_AQUI' \
  -H 'Accept: application/json' \

Produtos

GET/products

Listar produtos

Lista produtos do seu domínio.

Parâmetros

Exemplos de código

curl -X GET 'https://api.hyype.com.br/api/v1/products?status=active&type=course&per_page=25' \
  -H 'Authorization: Bearer SEU_TOKEN_AQUI' \
  -H 'Accept: application/json' \
POST/products

Criar produto

Cria um produto no domínio autenticado pelo token.

Body (JSON)

CampoTipoValores permitidos
nameobrigatóriostringtexto livre
descriptionstringtexto livre
long_descriptionstringtexto livre
typestringdigital, course, bundle, subscription, ebook, masterclass, consulting, membership, physical, digital_download, live_series
statusstringdraft, active, inactive, archived
base_pricenumbertexto livre
currency_codestringBRL, USD, EUR
is_featuredbooleantrue, false
metadataobjecttexto livre

Exemplos de código

curl -X POST 'https://api.hyype.com.br/api/v1/products' \
  -H 'Authorization: Bearer SEU_TOKEN_AQUI' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "Meu Produto",
  "description": "Descrição curta",
  "type": "course",
  "status": "draft",
  "base_price": 97,
  "currency_code": "BRL"
}'
GET/products/{id}

Obter produto

Detalhe com ofertas e entregáveis vinculados.

Parâmetros

Exemplos de código

curl -X GET 'https://api.hyype.com.br/api/v1/products/1' \
  -H 'Authorization: Bearer SEU_TOKEN_AQUI' \
  -H 'Accept: application/json' \
PUT/products/{id}

Atualizar produto

Atualiza campos do produto.

Parâmetros

Body (JSON)

CampoTipoValores permitidos
namestringtexto livre
descriptionstringtexto livre
typestringdigital, course, bundle, subscription, ebook, masterclass, consulting, membership, physical, digital_download, live_series
statusstringdraft, active, inactive, archived
base_pricenumbertexto livre
currency_codestringBRL, USD, EUR
is_featuredbooleantrue, false
slugstringtexto livre
metadataobjecttexto livre

Exemplos de código

curl -X PUT 'https://api.hyype.com.br/api/v1/products/1' \
  -H 'Authorization: Bearer SEU_TOKEN_AQUI' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "Produto Atualizado",
  "status": "active"
}'
DELETE/products/{id}

Remover produto

Remove o produto do catálogo ativo.

Parâmetros

Exemplos de código

curl -X DELETE 'https://api.hyype.com.br/api/v1/products/1' \
  -H 'Authorization: Bearer SEU_TOKEN_AQUI' \
  -H 'Accept: application/json' \

Ofertas

GET/offers

Listar ofertas

Ofertas de venda vinculadas a produtos do domínio.

Parâmetros

Exemplos de código

curl -X GET 'https://api.hyype.com.br/api/v1/offers?product_id=1&status=active' \
  -H 'Authorization: Bearer SEU_TOKEN_AQUI' \
  -H 'Accept: application/json' \
POST/offers

Criar oferta

Cria oferta vinculada a um product_id do seu domínio.

Body (JSON)

CampoTipoValores permitidos
product_idobrigatóriointegertexto livre
nameobrigatóriostringtexto livre
descriptionstringtexto livre
priceobrigatórionumbertexto livre
compare_at_pricenumbertexto livre
currency_codestringBRL, USD, EUR
billing_typestringone_time, recurring
billing_periodstringmonthly, quarterly, yearly
statusstringactive, inactive, sold_out
skustringtexto livre
is_defaultbooleantrue, false
metadataobjecttexto livre

Exemplos de código

curl -X POST 'https://api.hyype.com.br/api/v1/offers' \
  -H 'Authorization: Bearer SEU_TOKEN_AQUI' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "product_id": 1,
  "name": "Oferta principal",
  "price": 197,
  "currency_code": "BRL",
  "billing_type": "one_time",
  "status": "active"
}'
GET/offers/{id}

Obter oferta

Detalhe da oferta.

Parâmetros

Exemplos de código

curl -X GET 'https://api.hyype.com.br/api/v1/offers/1' \
  -H 'Authorization: Bearer SEU_TOKEN_AQUI' \
  -H 'Accept: application/json' \
PUT/offers/{id}

Atualizar oferta

Atualiza preço, status, cobrança e metadados.

Parâmetros

Body (JSON)

CampoTipoValores permitidos
namestringtexto livre
descriptionstringtexto livre
pricenumbertexto livre
compare_at_pricenumbertexto livre
currency_codestringBRL, USD, EUR
billing_typestringone_time, recurring
billing_periodstringmonthly, quarterly, yearly
statusstringactive, inactive, sold_out
skustringtexto livre
is_defaultbooleantrue, false
sales_page_urlstringtexto livre
metadataobjecttexto livre

Exemplos de código

curl -X PUT 'https://api.hyype.com.br/api/v1/offers/1' \
  -H 'Authorization: Bearer SEU_TOKEN_AQUI' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "price": 247,
  "status": "active"
}'
DELETE/offers/{id}

Remover oferta

Remove a oferta do catálogo ativo.

Parâmetros

Exemplos de código

curl -X DELETE 'https://api.hyype.com.br/api/v1/offers/1' \
  -H 'Authorization: Bearer SEU_TOKEN_AQUI' \
  -H 'Accept: application/json' \

Afiliados

GET/affiliates

Listar afiliados

Afiliados vinculados às ofertas do seu domínio.

Parâmetros

Exemplos de código

curl -X GET 'https://api.hyype.com.br/api/v1/affiliates?status=accepted&is_active=true' \
  -H 'Authorization: Bearer SEU_TOKEN_AQUI' \
  -H 'Accept: application/json' \
POST/affiliates

Criar afiliado

Convida ou cadastra afiliado em uma oferta.

Body (JSON)

CampoTipoValores permitidos
offer_idobrigatóriointegerID da oferta.
emailobrigatóriostringtexto livre
user_idintegertexto livre
commission_percentagenumbertexto livre
commission_fixednumbertexto livre
statusstringpending, accepted, rejected, expired
is_activebooleantrue, false
attribution_modelstringlast_click, first_click
cookie_duration_daysintegertexto livre

Exemplos de código

curl -X POST 'https://api.hyype.com.br/api/v1/affiliates' \
  -H 'Authorization: Bearer SEU_TOKEN_AQUI' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "offer_id": 1,
  "email": "[email protected]",
  "commission_percentage": 30,
  "status": "pending",
  "attribution_model": "last_click"
}'
GET/affiliates/{id}

Obter afiliado

Detalhe do vínculo de afiliado.

Parâmetros

Exemplos de código

curl -X GET 'https://api.hyype.com.br/api/v1/affiliates/1' \
  -H 'Authorization: Bearer SEU_TOKEN_AQUI' \
  -H 'Accept: application/json' \
PUT/affiliates/{id}

Atualizar afiliado

Comissão, status e ativação.

Parâmetros

Body (JSON)

CampoTipoValores permitidos
emailstringtexto livre
commission_percentagenumbertexto livre
commission_fixednumbertexto livre
statusstringpending, accepted, rejected, expired
is_activebooleantrue, false
attribution_modelstringlast_click, first_click
cookie_duration_daysintegertexto livre

Exemplos de código

curl -X PUT 'https://api.hyype.com.br/api/v1/affiliates/1' \
  -H 'Authorization: Bearer SEU_TOKEN_AQUI' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "commission_percentage": 40,
  "is_active": true,
  "status": "accepted"
}'
DELETE/affiliates/{id}

Remover afiliado

Remove o vínculo de afiliado.

Parâmetros

Exemplos de código

curl -X DELETE 'https://api.hyype.com.br/api/v1/affiliates/1' \
  -H 'Authorization: Bearer SEU_TOKEN_AQUI' \
  -H 'Accept: application/json' \

Entregáveis

GET/deliverables

Listar entregáveis

Conteúdos do domínio (cursos, ebooks, etc.).

Parâmetros

Exemplos de código

curl -X GET 'https://api.hyype.com.br/api/v1/deliverables?type=course&status=published' \
  -H 'Authorization: Bearer SEU_TOKEN_AQUI' \
  -H 'Accept: application/json' \
POST/deliverables

Criar entregável

Cria entregável base. Use um dos tipos permitidos.

Body (JSON)

CampoTipoValores permitidos
nameobrigatóriostringtexto livre
typeobrigatóriostringcourse, ebook, document, masterclass, live_series, consulting, community, app, members_area
descriptionstringtexto livre
statusstringdraft, published, active, inactive
thumbnail_urlstringtexto livre
sort_orderintegertexto livre
metadataobjecttexto livre

Exemplos de código

curl -X POST 'https://api.hyype.com.br/api/v1/deliverables' \
  -H 'Authorization: Bearer SEU_TOKEN_AQUI' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "Curso Completo",
  "type": "course",
  "status": "draft",
  "description": "Conteúdo principal"
}'
GET/deliverables/{id}

Obter entregável

Detalhe com tipo e produtos vinculados.

Parâmetros

Exemplos de código

curl -X GET 'https://api.hyype.com.br/api/v1/deliverables/1' \
  -H 'Authorization: Bearer SEU_TOKEN_AQUI' \
  -H 'Accept: application/json' \
PUT/deliverables/{id}

Atualizar entregável

Atualiza metadados e status.

Parâmetros

Body (JSON)

CampoTipoValores permitidos
namestringtexto livre
typestringcourse, ebook, document, masterclass, live_series, consulting, community, app, members_area
descriptionstringtexto livre
statusstringdraft, published, active, inactive
thumbnail_urlstringtexto livre
sort_orderintegertexto livre
metadataobjecttexto livre

Exemplos de código

curl -X PUT 'https://api.hyype.com.br/api/v1/deliverables/1' \
  -H 'Authorization: Bearer SEU_TOKEN_AQUI' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "status": "published"
}'
DELETE/deliverables/{id}

Remover entregável

Remove o entregável do catálogo ativo.

Parâmetros

Exemplos de código

curl -X DELETE 'https://api.hyype.com.br/api/v1/deliverables/1' \
  -H 'Authorization: Bearer SEU_TOKEN_AQUI' \
  -H 'Accept: application/json' \

Vendas

GET/sales

Listar vendas

Vendas do domínio com filtros de status, meio de pagamento e período.

Parâmetros

Exemplos de código

curl -X GET 'https://api.hyype.com.br/api/v1/sales?status=paid&payment_method=pix&from=2026-01-01&to=2026-12-31' \
  -H 'Authorization: Bearer SEU_TOKEN_AQUI' \
  -H 'Accept: application/json' \
GET/sales/report

Relatório de vendas

Agregados: totais pagos, por método e por dia.

Parâmetros

Exemplos de código

curl -X GET 'https://api.hyype.com.br/api/v1/sales/report?from=2026-01-01&to=2026-12-31' \
  -H 'Authorization: Bearer SEU_TOKEN_AQUI' \
  -H 'Accept: application/json' \
GET/sales/{id}

Obter venda

Detalhe da venda com itens.

Parâmetros

Exemplos de código

curl -X GET 'https://api.hyype.com.br/api/v1/sales/1' \
  -H 'Authorization: Bearer SEU_TOKEN_AQUI' \
  -H 'Accept: application/json' \

Checkout / Carrinhos

GET/checkout-sessions

Listar sessões

Carrinhos da loja e/ou do checkout digital. Use source=store|digital|all.

Parâmetros

Exemplos de código

curl -X GET 'https://api.hyype.com.br/api/v1/checkout-sessions?source=all&status=abandoned' \
  -H 'Authorization: Bearer SEU_TOKEN_AQUI' \
  -H 'Accept: application/json' \
GET/checkout-sessions/abandoned

Carrinhos abandonados

Atalho para recuperação de carrinho abandonado.

Parâmetros

Exemplos de código

curl -X GET 'https://api.hyype.com.br/api/v1/checkout-sessions/abandoned?source=digital' \
  -H 'Authorization: Bearer SEU_TOKEN_AQUI' \
  -H 'Accept: application/json' \
GET/checkout-sessions/{id}

Obter sessão

Detalhe por id numérico ou token do carrinho da loja.

Parâmetros

Exemplos de código

curl -X GET 'https://api.hyype.com.br/api/v1/checkout-sessions/1' \
  -H 'Authorization: Bearer SEU_TOKEN_AQUI' \
  -H 'Accept: application/json' \

Leads

GET/leads

Listar leads

Leads capturados no seu domínio.

Parâmetros

Exemplos de código

curl -X GET 'https://api.hyype.com.br/api/v1/leads' \
  -H 'Authorization: Bearer SEU_TOKEN_AQUI' \
  -H 'Accept: application/json' \
POST/leads

Criar/atualizar lead

Cria lead ou atualiza se o e-mail já existir.

Body (JSON)

CampoTipoValores permitidos
emailobrigatóriostringtexto livre
namestringtexto livre
phonestringtexto livre
notesstringtexto livre
sourcestringOrigem do lead (texto livre, ex.: partner_api, ads, organic).

Exemplos de código

curl -X POST 'https://api.hyype.com.br/api/v1/leads' \
  -H 'Authorization: Bearer SEU_TOKEN_AQUI' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "email": "[email protected]",
  "name": "Lead Exemplo",
  "phone": "11988887777",
  "source": "partner_api"
}'
GET/leads/{id}

Obter lead

Detalhe do lead.

Parâmetros

Exemplos de código

curl -X GET 'https://api.hyype.com.br/api/v1/leads/1' \
  -H 'Authorization: Bearer SEU_TOKEN_AQUI' \
  -H 'Accept: application/json' \
PUT/leads/{id}

Atualizar lead

Notas, telefone e flags.

Parâmetros

Body (JSON)

CampoTipoValores permitidos
namestringtexto livre
phonestringtexto livre
notesstringtexto livre
sourcestringtexto livre
is_clientbooleantrue, false

Exemplos de código

curl -X PUT 'https://api.hyype.com.br/api/v1/leads/1' \
  -H 'Authorization: Bearer SEU_TOKEN_AQUI' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "notes": "Contatado via WhatsApp",
  "is_client": false
}'
DELETE/leads/{id}

Remover lead

Exclui o lead.

Parâmetros

Exemplos de código

curl -X DELETE 'https://api.hyype.com.br/api/v1/leads/1' \
  -H 'Authorization: Bearer SEU_TOKEN_AQUI' \
  -H 'Accept: application/json' \

Tracking

GET/tracking/pixels

Listar pixels

Pixels de conversão nos produtos (sem expor segredos).

Parâmetros

Exemplos de código

curl -X GET 'https://api.hyype.com.br/api/v1/tracking/pixels?platform=meta_ads' \
  -H 'Authorization: Bearer SEU_TOKEN_AQUI' \
  -H 'Accept: application/json' \
GET/tracking/summary

Resumo de tracking

Totais por plataforma.

Exemplos de código

curl -X GET 'https://api.hyype.com.br/api/v1/tracking/summary' \
  -H 'Authorization: Bearer SEU_TOKEN_AQUI' \
  -H 'Accept: application/json' \

Logs de mensageria

GET/messaging-logs

Listar logs

Fila de mensagens enviadas apenas deste domínio (e-mail, WhatsApp, push).

Parâmetros

Exemplos de código

curl -X GET 'https://api.hyype.com.br/api/v1/messaging-logs?channel=email&status=sent' \
  -H 'Authorization: Bearer SEU_TOKEN_AQUI' \
  -H 'Accept: application/json' \
GET/messaging-logs/{id}

Obter log

Detalhe de uma mensagem na fila.

Parâmetros

Exemplos de código

curl -X GET 'https://api.hyype.com.br/api/v1/messaging-logs/%7Bid%7D' \
  -H 'Authorization: Bearer SEU_TOKEN_AQUI' \
  -H 'Accept: application/json' \