# Handle.connected

URL: /business/events/Handle.connected · Id: `event:Handle.connected`

> Emitted each time a Handle is connected.

[Handle.connect](/business/nouns/handle/connect) emits `Handle.connected` when it completes on a [Handle](/business/nouns/handle).

| Property | Value |
| --- | --- |
| Emitted by | [Handle.connect](/business/nouns/handle/connect) |
| Noun | [Handle](/business/nouns/handle) |
| Wakes | None. |

### Payload
Each delivery is an [Event](/business/nouns/event) record. `data` holds what [Handle.connect](/business/nouns/handle/connect) returns.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | `string` | Yes | `Handle.connected`. |
| `at` | `datetime` | Yes | When it happened. |
| `seq` | `integer` | No | Its position in the namespace, one more than the Event before; any seq is a cursor into the history. |
| `data` | `json` | Yes | The Thing as the Action left it. |
| `data.handle` | [Handle](/business/nouns/handle) | Yes | The connected Handle. |
| `data.handle.venue` | `string` | Yes | The venue it lives on, by id. |
| `data.handle.name` | `string` | Yes | The name as the platform shows it, such as `@example`. |
| `data.handle.shared` | `boolean` | No | True for a Studio account shared across sibling Startups; every Post names the Startup it speaks for. |
| `data.handle.agent` | `boolean` | No | True when an Agent runs it; its bio says so. |
| `data.handle.integration` | [Integration](/business/nouns/integration) | No | The Integration credential it publishes through. |

### Example
```json
{
  "$id": "https://api.sb/tutorloop.com/events/event_1",
  "$type": "Event",
  "name": "Handle.connected",
  "at": "2026-10-22T12:00:00Z",
  "data": {
    "handle": {
      "$id": "https://api.sb/tutorloop.com/handles/handle_1",
      "$type": "Handle",
      "venue": "Example venue",
      "name": "TutorLoop",
      "shared": true,
      "agent": true,
      "integration": "integration_1"
    }
  },
  "seq": 1
}
```