Skip to main content
GET
/
v3
/
projects
/
{project_id}
/
connections
Listar conexões de um projeto
curl --request GET \
  --url https://api.metrito.com/v3/projects/{project_id}/connections \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": "64a1b2c3d4e5f6a7b8c9d0e1",
    "source": "Meta Ads",
    "source_id": "act_123456789",
    "name": "Conta Principal Meta",
    "status": "active",
    "workspace_id": "60f1b2c3d4e5f6a7b8c9d0e1",
    "webhook_url": null
  },
  {
    "id": "64a1b2c3d4e5f6a7b8c9d0e2",
    "source": "Google Ads",
    "source_id": "123-456-7890",
    "name": "Google Ads Loja",
    "status": "active",
    "workspace_id": "60f1b2c3d4e5f6a7b8c9d0e1",
    "webhook_url": null
  },
  {
    "id": "64a1b2c3d4e5f6a7b8c9d0e3",
    "source": "Personalizado",
    "source_id": null,
    "name": "Webhook Hotmart",
    "status": "active",
    "workspace_id": "60f1b2c3d4e5f6a7b8c9d0e1",
    "webhook_url": "https://api.metrito.com/v2/tracking/generic?k=abc123"
  }
]

​
Autenticação

Este endpoint aceita dois formatos de autenticação:
  1. JWT da plataforma
    • Header: Authorization: Bearer {jwt}
  2. API Key do Metrito
    • Header: Authorization: Bearer mtk_live_... ou x-api-key: mtk_live_...
    • Requer escopo data:read
    • O projeto deve pertencer ao workspace vinculado à chave

Authorizations

​
Authorization
string
header
required

JWT da plataforma ou API key mtk_live_... enviada no header Authorization

Path Parameters

​
project_id
string
required

ID do projeto.

Example:

"69162064162b926ae607959b"

Response

Lista de conexões retornada com sucesso

​
id
string

ID da conexão

​
source
string

Nome da fonte de dados (Meta Ads, Google Ads, TikTok Ads, Personalizado, etc.)

​
source_id
string | null

ID da conta na plataforma de origem (ex. act_123456 para Meta)

​
name
string

Nome dado à conexão pelo usuário

​
status
enum<string>

Status atual da conexão

Available options:
active,
error,
paused,
disabled
​
workspace_id
string

ID do workspace

​
webhook_url
string | null

URL do webhook (apenas para conexões do tipo Personalizado)