Connect an Account

POST

https://api.cobre.co/v1/accounts

This endpoint serves as a cornerstone for Cobre Platform users, offering the ability to manage financial institution accounts with ease. It facilitates the processes of connecting to existing ones within our ecosystem.

See Managing Connect Accounts guide

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

Examples

Responses

🟢201Creado

application/json

Headers

Body

🟠409Conflicto

Request Example

Shell

JavaScript

Java

Swift

cURL

Connect Account (CO)Connect Account (MX)

curl --location --request POST 'https://api.cobre.co/v1/accounts' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "provider_id": "pr_col_1007",
    "action": "connect",
    "account_type": "cc",
    "tags": "payroll",
    "metadata": {
        "account_number": "072122333322221111",
        "account_holder_id_type": "nit",
        "account_holder_id_number": "96542216"
    },
    "alias": "Payroll Account"
}'

Response Example

201 - Connect Account (CO)

{
    "id": "acc_BFDsK9pYov",
    "connectivity": {
        "status": "connecting",
        "description": ""
    },
    "alias": "Connect de Bancolombia",
    "metadata": {
        "available_services": [
            "",
            "account_balance",
            "mm_push_from_account",
            "account_transactions"
        ],
        "contract_number": ""
    },
    "currency": "cop",
    "geo": "col",
    "tags": [
        "accounting"
    ],
    "provider_id": "pr_col_1007",
    "provider_name": "Bancolombia",
    "account_number": "*******2988",
    "account_type": "cc",
    "obtained_balance": 500000000,
    "obtained_balance_at": "2025-11-25T15:02:28Z",
    "created_at": "2025-11-25T15:02:28Z",
    "updated_at": "2025-11-25T15:02:28Z"
}

Modified at 2026-01-06 00:55:33

Unlinking Primary Account

Obtain one Connected Account