Create a Cobre Balance

POST

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

Create a new balance (virtual balance) in the Cobre platform so your integration can hold and operate funds under a defined entity. Use this as the first step before initiating money movements tied to that balance.

See Managing Cobre Balances guide

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Body Params application/jsonRequired

Examples

Responses

🟢201Success

application/json

Headers

Body

🟠409Error response

Request Example

Shell

JavaScript

Java

Swift

cURL

Colombia Cobre BalanceMexico Cobre BalanceGlobal Cobre Balance

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_cobre",
    "action": "create",
    "tags": [
        "This is a tag"
    ],
    "alias": "My first Cobre Balance Colombia"
}'

Response Example

201 - Mexico Cobre Balance

{
    "id": "acc_1212534tdfgs",
    "provider_id": "pr_mex_cobre",
    "provider_name": "Cobre Balance Mexico",
    "connectivity": {
        "status": "connected",
        "description": "string"
    },
    "alias": "My first Cobre account!",
    "metadata": {
        "available_services": [
            "mm_push_from_account"
        ],
        "primary_account": "acc_2NDkMRjA1o"
    },
    "account_number": "646180303700100016",
    "account_type": "clabe",
    "obtained_balance": 10000,
    "obtained_balance_at": "2024-07-05T11:21:34Z",
    "geo": "mex",
    "tags": [
        "accounting"
    ],
    "currency": "mxn",
    "created_at": "2024-06-17T17:34:50Z",
    "updated_at": "2024-07-05T11:21:34Z"
}

Modified at 2026-01-06 03:14:30

Authentication

Obtain all Accounts