Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.natural.co/llms.txt

Use this file to discover all available pages before exploring further.

Agents execute transactions within the Natural ecosystem on behalf of customers.

​
Via Dashboard

  1. Navigate to Agents tab in your dashboard
  2. Click Create Agent
  3. Store the returned agentId in your database - you’ll need it for future calls.

​
Via API

curl -X POST https://api.natural.co/agents \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "data": {
      "attributes": {
        "name": "Maintenance Request Agent",
        "description": "Processes maintenance requests for property managers",
        "limits": {
          "perTransaction": 100000
        }
      }
    }
  }'
The limits.perTransaction field sets a per-transaction limit in cents (e.g., 100000 = $1,000). Omit for unlimited.
Response: 
{
  "data": {
    "type": "agent",
    "id": "agt_019cd1798d637a4da75dce386343931d",
    "attributes": {
      "name": "Maintenance Request Agent",
      "description": "Processes maintenance requests for property managers",
      "status": "ACTIVE",
      "createdAt": "2026-01-04T15:30:00Z",
      "createdBy": "usr_019cd1798d657de5b5fed4198cb9fac0"
    },
    "relationships": {
      "party": {
        "data": {
          "type": "party",
          "id": "pty_019cd1798d617f65a79cb965dda9eac3"
        }
      }
    }
  }
}

​
Configure limits and escalations

Set transaction, daily, and weekly limits via dashboard or API:
  • Per-transaction limit - Maximum amount per payment
  • Daily limit - Maximum total per day
  • Weekly limit - Maximum total per week
Escalations: Configure notifications via email or SMS when agents exceed limits. Connect your notification channels in Settings.

​
Next step

Onboard a Customer

Add customers to transact on behalf of