---
title: "POST /connections/events"
method: POST
path: "/connections/events"
tags: ["connections"]
---

# POST /connections/events

`POST /connections/events`

## Request

- Base URL: `https://api.betteroff.finance`
- URL: `https://api.betteroff.finance/connections/events`
- Auth: HTTP bearer

## Request body

- object
  - `provider` 'plaid', required
  - `event` 'plaid.link_opened' | 'plaid.link_exited' | 'plaid.link_succeeded', required
  - `attemptId` string, uuid
  - `mode` 'create' | 'update'
  - `connectionId` string
  - `institutionId` string
  - `institutionName` string
  - `linkSessionId` string
  - `errorCode` string
  - `errorClass` string
  - `metadata` object
    - `exit_kind` 'customer_exit' | 'provider_error' | 'betteroff_error' | 'unknown'
    - `exit_stage` 'institution' | 'credentials' | 'verification' | 'oauth' | 'account_selection' | 'completion' | 'unknown'
    - `duration_band` 'under_10s' | '10_to_30s' | '30_to_120s' | '2_to_5m' | 'over_5m' | 'unknown'
    - `retryable` boolean
    - `sdk_status` 'requires_institution' | 'requires_credentials' | 'requires_verification' | 'requires_oauth' | 'requires_account_selection' | 'complete' | 'unknown'

## Response `204`

No content

## Other responses

- `default`: Problem details

---

[API](https://skmtc.dev/betteroff/apis/betteroff-api.md) · [All operations](https://skmtc.dev/betteroff/apis/betteroff-api/llms.txt) · [OpenAPI document](https://skmtc.dev/betteroff/apis/betteroff-api/revisions/bc858c8d428d?raw)