> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentcard.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Blooio connection

> Connect your organization's Blooio account so Agentcard can send wallet links from your own Blooio numbers.

If your iMessage agent runs on [Blooio](https://blooio.com), you can connect your Blooio account to Agentcard once. After that, Agentcard sends wallet and approval links from your Blooio numbers, within the scopes you granted, so the user sees them in the same thread as your agent.

The flow is OAuth: you request a consent URL, send your operator to it, they approve in Blooio, and Blooio redirects back to Agentcard. Agentcard stores the tokens encrypted and reports the connection here.

## The Blooio connection object

| Field                      | Type           | Description                                                          |
| -------------------------- | -------------- | -------------------------------------------------------------------- |
| `object`                   | string         | `blooio_connection`                                                  |
| `connected`                | boolean        | Always true when the object exists. A missing connection is a `404`. |
| `blooio_organization_ids`  | string\[]      | The Blooio organizations the install covers.                         |
| `scopes`                   | string\[]      | What Blooio granted (for example `messages:send`).                   |
| `token_expires_at`         | string or null | When Blooio's token expires. Agentcard refreshes it.                 |
| `created_at`, `updated_at` | string         |                                                                      |

```json theme={null}
{ "object": "blooio_connection", "connected": true, "blooio_organization_ids": ["borg_…"], "scopes": ["messages:send", "numbers:read"], "token_expires_at": "2026-10-07T17:00:00Z", "created_at": "2026-09-07T17:00:00Z", "updated_at": "2026-09-07T17:00:00Z" }
```

## Endpoints

| Endpoint                          |                                                                                           |
| --------------------------------- | ----------------------------------------------------------------------------------------- |
| `POST /api/v2/blooio/oauth/start` | [Start the Blooio connection](/api-reference/blooio/oauth-start): returns the consent URL |
| `GET /api/v2/blooio/connection`   | [Get the Blooio connection](/api-reference/blooio/connection)                             |