> ## 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 Vault 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 add-a-card 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) |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.