PT EN

Connections

Eventos de Connections: 10 no total. Ver o envelope comum.

connection.application_created

A connection application was opened.

Recurso: connection

Não suportado por `events trigger` (use o fluxo normal da API).

Exemplo de payload
{
  "id": "wev_WcN38CD4ieyLJHzQWE2MqZ39BHR",
  "type": "connection.application_created",
  "api_version": "v1",
  "tenant_id": "ten_dMtYBHqoMswJA34fM24koBkTzKe",
  "created_at": "2026-11-19T09:30:00Z",
  "data": {
    "resource_type": "connection",
    "resource_id": "con_WcN38CD4iewAq4fcSHLdfTmRcX5",
    "resource": {
      "type": "connection",
      "id": "con_WcN38CD4iewAq4fcSHLdfTmRcX5",
      "sequence": 1
    }
  }
}

connection.application_reviewed

A connection application was reviewed.

Recurso: connection

Não suportado por `events trigger` (use o fluxo normal da API).

Exemplo de payload
{
  "id": "wev_WcN38CD4ieyLJHzQWE2MqZ33sCe",
  "type": "connection.application_reviewed",
  "api_version": "v1",
  "tenant_id": "ten_dMtYBHqoMswJA34fM24koBkTzKe",
  "created_at": "2026-11-19T09:30:00Z",
  "data": {
    "resource_type": "connection",
    "resource_id": "con_WcN38CD4iewAq4fcSHLdfTmRcX5",
    "resource": {
      "type": "connection",
      "id": "con_WcN38CD4iewAq4fcSHLdfTmRcX5",
      "sequence": 1
    }
  }
}

connection.application_submitted

A connection application was submitted.

Recurso: connection

Não suportado por `events trigger` (use o fluxo normal da API).

Exemplo de payload
{
  "id": "wev_WcN38CD4ieyLJHzQWE2MqZ3EBfE",
  "type": "connection.application_submitted",
  "api_version": "v1",
  "tenant_id": "ten_dMtYBHqoMswJA34fM24koBkTzKe",
  "created_at": "2026-11-19T09:30:00Z",
  "data": {
    "resource_type": "connection",
    "resource_id": "con_WcN38CD4iewAq4fcSHLdfTmRcX5",
    "resource": {
      "type": "connection",
      "id": "con_WcN38CD4iewAq4fcSHLdfTmRcX5",
      "sequence": 1
    }
  }
}

connection.installation_scheduled

A connection installation was scheduled.

Recurso: connection

Não suportado por `events trigger` (use o fluxo normal da API).

Exemplo de payload
{
  "id": "wev_WcN38CD4ieysRLYQ4uwABAbPnV6",
  "type": "connection.installation_scheduled",
  "api_version": "v1",
  "tenant_id": "ten_dMtYBHqoMswJA34fM24koBkTzKe",
  "created_at": "2026-11-19T09:30:00Z",
  "data": {
    "resource_type": "connection",
    "resource_id": "con_WcN38CD4iewAq4fcSHLdfuY64qu",
    "resource": {
      "type": "connection",
      "id": "con_WcN38CD4iewAq4fcSHLdfuY64qu",
      "sequence": 1
    }
  }
}

connection.installed

A connection was installed.

Recurso: connection

Não suportado por `events trigger` (use o fluxo normal da API).

Exemplo de payload
{
  "id": "wev_WcN38CD4ieysRLYQ4uiSebfyUCZ",
  "type": "connection.installed",
  "api_version": "v1",
  "tenant_id": "ten_dMtYBHqoMswJA34fM24koBkTzKe",
  "created_at": "2026-11-19T09:30:00Z",
  "data": {
    "resource_type": "connection",
    "resource_id": "con_WcN38CD4iewAq4fcSHLdfuY64qu",
    "resource": {
      "type": "connection",
      "id": "con_WcN38CD4iewAq4fcSHLdfuY64qu",
      "sequence": 1
    }
  }
}

connection.reconnected

A connection was restored.

Recurso: connection

Não suportado por `events trigger` (use o fluxo normal da API).

Exemplo de payload
{
  "id": "wev_WcN38CD4ieyzC6BrseqM5BJ9e4g",
  "type": "connection.reconnected",
  "api_version": "v1",
  "tenant_id": "ten_dMtYBHqoMswJA34fM24koBkTzKe",
  "created_at": "2026-11-19T09:30:00Z",
  "data": {
    "resource_type": "connection",
    "resource_id": "con_WcN38CD4iewAq4fcSHLdfjBjjvs",
    "resource": {
      "type": "connection",
      "id": "con_WcN38CD4iewAq4fcSHLdfjBjjvs",
      "sequence": 1
    }
  }
}

connection.retired

A connection was retired.

Recurso: connection

Não suportado por `events trigger` (use o fluxo normal da API).

Exemplo de payload
{
  "id": "wev_WcN38CD4ieyzCDRb3zRMZgG6ZTm",
  "type": "connection.retired",
  "api_version": "v1",
  "tenant_id": "ten_dMtYBHqoMswJA34fM24koBkTzKe",
  "created_at": "2026-11-19T09:30:00Z",
  "data": {
    "resource_type": "connection",
    "resource_id": "con_WcN38CD4iewAq4fcSHLdfjBJZZF",
    "resource": {
      "type": "connection",
      "id": "con_WcN38CD4iewAq4fcSHLdfjBJZZF",
      "sequence": 1
    }
  }
}

connection.status_changed

A connection changed status.

Recurso: connection

Não suportado por `events trigger` (use o fluxo normal da API).

Exemplo de payload
{
  "id": "wev_WcN38CD4ieyonEvLd4eiMBxeZNA",
  "type": "connection.status_changed",
  "api_version": "v1",
  "tenant_id": "ten_dMtYBHqoMswJA34fM24koBkTzKe",
  "created_at": "2026-11-19T09:30:00Z",
  "data": {
    "resource_type": "connection",
    "resource_id": "con_WcN38CD4iewAq4fcSHLdfvSDF2z",
    "resource": {
      "type": "connection",
      "id": "con_WcN38CD4iewAq4fcSHLdfvSDF2z",
      "sequence": 1
    }
  }
}

connection.suspended

A connection was suspended.

Recurso: connection

Não suportado por `events trigger` (use o fluxo normal da API).

Exemplo de payload
{
  "id": "wev_WcN38CD4ieyoyvXVUbWbGBkoUyq",
  "type": "connection.suspended",
  "api_version": "v1",
  "tenant_id": "ten_dMtYBHqoMswJA34fM24koBkTzKe",
  "created_at": "2026-11-19T09:30:00Z",
  "data": {
    "resource_type": "connection",
    "resource_id": "con_WcN38CD4iewAq4fcSHLdfvFWFnV",
    "resource": {
      "type": "connection",
      "id": "con_WcN38CD4iewAq4fcSHLdfvFWFnV",
      "sequence": 1
    }
  }
}

connection.updated

A connection changed.

Recurso: connection

Não suportado por `events trigger` (use o fluxo normal da API).

Exemplo de payload
{
  "id": "wev_WcN38CD4ieyCUoxQaupa9noUtTb",
  "type": "connection.updated",
  "api_version": "v1",
  "tenant_id": "ten_dMtYBHqoMswJA34fM24koBkTzKe",
  "created_at": "2026-11-19T09:30:00Z",
  "data": {
    "resource_type": "connection",
    "resource_id": "con_WcN38CD4iewAq4fcSHLdfmC5R2r",
    "resource": {
      "type": "connection",
      "id": "con_WcN38CD4iewAq4fcSHLdfmC5R2r",
      "sequence": 1
    }
  }
}

Receber estes eventos

O seu endpoint de webhook recebe cada um destes eventos num POST com o envelope comum, descrito na tabela abaixo. Verifique a assinatura antes de agir, responda depressa com um código 2xx e faça o trabalho depois: uma resposta lenta ou falhada é enviada outra vez. O mesmo evento pode chegar mais de uma vez, por isso use o seu id para ignorar repetições.

CampoTipoSignificado
idstringIdentificador do evento; o mesmo em todas as tentativas de entrega.
typestringO nome do evento, por exemplo invoice.issued.
api_versionstringA versão da API em que o corpo é escrito.
tenant_idstringA empresa (espaço de trabalho) onde o evento aconteceu.
created_atstring (RFC 3339)Quando o evento foi registado.
request_idstringO pedido à API que causou a mudança, quando houve um; liga ao registo de pedidos.
data.resource_typestringO tipo do recurso que mudou.
data.resource_idstringO identificador desse recurso, para o ler na API.
data.attributesobjectCampos próprios de cada evento; podem não existir. Leia o recurso na API para o estado completo.
data.resource.sequenceintegerConta os eventos do mesmo recurso; ignore um evento que não seja mais recente do que o último que aplicou.

Outras categorias de eventos