Resource tags - Natural Docs

August 25, 2026

You can now attach custom metadata to Natural resources. Pass a tags object of key-value pairs when you create a payment, transfer, wallet, agent, webhook, or most other resources, and Natural stores it and returns it on every read. Use tags to carry custom identifiers through Natural: an internal order ID on a payment, a team name on a wallet, an environment label on an API key. When the resource comes back in an API response or a webhook event, your tags come with it, so you can reconcile against your own systems.

{
  "tags": {
    "order_id": "ord_8213",
    "team": "marketplace"
  }
}

See tags in action in the API reference.