Contents
On this page

Update Rate Alerts - Plugixa Multi Currency for WooCommerce

PUT /plugixa-multi-currency/v1/pro/rate-alerts

Save the rate alert settings. Only the fields you send change. PUT and POST work the same way.

Needs a user with the plugixa_multi_currency_manage_settings capability (signed in with an Application Password, or the login cookie with an X-WP-Nonce header). Administrators hold it; see Capabilities.

Note. Pro only: on the free plugin this route answers 404 rest_no_route.

Request

PUT https://your-store.example/wp-json/plugixa-multi-currency/v1/pro/rate-alerts

Request body

Content type: application/json

Field Type Required Description
threshold string No Change in percent, 0 to 100, from which an update counts as a big move.
email boolean No Email when a rate moves more than the threshold.
recipient string No Who gets the email. Empty sends it to the site’s admin email.
hold boolean No Hold big moves for your approval instead of applying them.

A threshold outside 0 to 100, or an invalid email, is ignored or saved empty.

{
  "threshold": "2",
  "hold": true,
  "recipient": "finance@your-store.example"
}

Responses

200 OK. data is the settings and the held rates, as in Get Rate Alerts.

{
  "success": true,
  "data": {
    "threshold": "2",
    "email": true,
    "recipient": "finance@your-store.example",
    "hold": true,
    "held": [
      {
        "id": 431,
        "currency": "INR",
        "rate": "95.4012",
        "current": "92.6751592356",
        "change": "2.94",
        "provider": "ecb",
        "fetched_at": "2026-11-21 15:30:04"
      }
    ],
    "admin_email": "owner@your-store.example"
  }
}

Errors

Status Code When
401 / 403 rest_forbidden The caller lacks the capability: Sorry, you are not allowed to do that.

Plus the errors every endpoint can return.

Examples

curl -s -X PUT "https://your-store.example/wp-json/plugixa-multi-currency/v1/pro/rate-alerts" \
  -u "$WP_USER:$WP_APP_PASSWORD" \
  -H "Content-Type: application/json" \
  -d '{"threshold":"2","hold":true,"recipient":"finance@your-store.example"}'
<?php
$ch = curl_init('https://your-store.example/wp-json/plugixa-multi-currency/v1/pro/rate-alerts');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST  => 'PUT',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_USERPWD        => getenv('WP_USER') . ':' . getenv('WP_APP_PASSWORD'),
    CURLOPT_HTTPHEADER     => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS     => json_encode([
        'threshold' => '2',
        'hold'      => true,
        'recipient' => 'finance@your-store.example',
    ]),
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
const response = await fetch('https://your-store.example/wp-json/plugixa-multi-currency/v1/pro/rate-alerts', {
  method: 'PUT',
  headers: {
    'Authorization': `Basic ${btoa(`${process.env.WP_USER}:${process.env.WP_APP_PASSWORD}`)}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ threshold: '2', hold: true, recipient: 'finance@your-store.example' }),
});
const { data } = await response.json();

Quick Links

Share