Create Alert

This API allows you to create FX rate monitoring alerts for specific currency pairs. To create an alert, simply provide the currency pair, condition type (above, below, or within_range), rate thresholds, and expiration date. The API will return the created alert object with a unique identifier and active status.

See FX Alerts

Common Mistakes

Setting max_rate without specifying condition above or within_range.

Setting min_rate without specifying condition below or within_range.

Using unsupported currency pairs outside of usd/cop , cop/usd, usd/mxn, mxn/cop.

Setting valid_until dates in the past or without proper ISO 8601 formatting.

Forgetting to subscribe to alerts.fx_rate.triggered webhooks before creating alerts.

Using camelCase field names in request body (use snake_case: currency_pair, max_rate, min_rate).

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

curl --location --request POST 'https://api.cobre.co/v1v1/alerts' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "type": "fx_rate", "alias": "Above Example", "metadata": { "condition": "above", "currency_pair": "usd/cop", "max_rate": 3500 }, "valid_until": "2026-05-17T04:00:00Z" }'

{ "id": "alt_7vH5YA5CI4", "creator": "usr_68TbxU1Uif", "type": "fx_rate", "alias": "Above Example", "active_status": true, "metadata": { "condition": "above", "currency_pair": "usd/cop", "max_rate": 3500 }, "valid_until": "2026-05-17T04:00:00Z", "created_at": "2026-04-17T04:36:58Z", "updated_at": "2026-04-17T04:36:58Z" }

Create Alert

Common Mistakes

Request

Responses

Create Alert

Common Mistakes#

Request

Responses

Common Mistakes