Connections

Connections events: 10 in all. See the shared envelope.

connection.application_created

A connection application was opened.

Resource: connection

Not supported by `events trigger` (use the normal API flow).

Example 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.

Resource: connection

Not supported by `events trigger` (use the normal API flow).

Example 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.

Resource: connection

Not supported by `events trigger` (use the normal API flow).

Example 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.

Resource: connection

Not supported by `events trigger` (use the normal API flow).

Example 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.

Resource: connection

Not supported by `events trigger` (use the normal API flow).

Example 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.

Resource: connection

Not supported by `events trigger` (use the normal API flow).

Example 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.

Resource: connection

Not supported by `events trigger` (use the normal API flow).

Example 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.

Resource: connection

Not supported by `events trigger` (use the normal API flow).

Example 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.

Resource: connection

Not supported by `events trigger` (use the normal API flow).

Example 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.

Resource: connection

Not supported by `events trigger` (use the normal API flow).

Example 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
    }
  }
}

Receiving these events

Your webhook endpoint receives each of these events as a POST with the shared envelope described in the table below. Check the signature before acting on it, answer quickly with a 2xx code and do the work afterwards: a slow or failed answer is sent again. The same event can arrive more than once, so use its id to ignore repeats.

FieldTypeMeaning
idstringThe event identifier; the same on every delivery attempt.
typestringThe event name, for example invoice.issued.
api_versionstringThe API version the body is written in.
tenant_idstringThe utility (workspace) where the event happened.
created_atstring (RFC 3339)When the event was recorded.
request_idstringThe API request that caused the change, when there was one; links to the request log.
data.resource_typestringThe type of the resource that changed.
data.resource_idstringThat resource's identifier, to read it from the API.
data.attributesobjectFields specific to each event; may be absent. Read the resource from the API for its full state.
data.resource.sequenceintegerCounts the events about the same resource; ignore an event that is not newer than the last one you applied.

Other event categories