Subscribe to Events

POST

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

This endpoint allows the creation of a subscription to events and the location where notifications must be sent.

See Notifications & Suscriptions 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

Created

Body

🟠409Conflicto

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.cobre.co/v1/subscriptions' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "url": "https://myurlforsubscriptions.com",
    "description": "My First Subscription",
    "events": [
        "accounts.balance.credit",
        "accounts.balance.debit",
        "money_movements.status.initiated",
        "money_movements.status.failed",
        "money_movements.status.processing",
        "money_movements.status.completed",
        "money_movements.status.rejected"
    ],
    "event_signature_key": "ABCDE12345"
}'

Response Example

201 - Response Notification

{
    "id": "sub_zod5IW",
    "url": "https://myurlforsubscriptions.com",
    "description": "My First Subscription",
    "events": [
        "accounts.balance.credit",
        "accounts.balance.debit",
        "money_movements.status.initiated",
        "money_movements.status.failed",
        "money_movements.status.processing",
        "money_movements.status.completed",
        "money_movements.status.rejected"
    ],
    "event_signature_key": "******45",
    "created_at": "24-06-14T09:35:37Z"
}

Modified at 2026-01-06 03:01:41

Create a Cobre Balance Statement

Obtain all Subcriptions