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.

After creating your account and agent, you need customers to transact on behalf of. If you’re using Natural directly to send money, this step won’t be necessary - skip to Send Payment. There are two methods for onboarding customers.

​
Via delegation invitations flow

  1. Send invitation in Dashboard’s Counterparties tab OR
  2. Send invitation via API: 
    curl -X POST https://api.natural.co/agents/invitations \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "customerEmail": "bruce@propertymanagement.com",
    "agents": [
      {
        "agentId": "agt_019cd1798d637a4da75dce386343931d",
        "permissions": ["payments.create"]
      }
    ]
  }'
    Response: one invitation row per requested agent. The customer receives a single email listing all invited agents and accepts each from a grouped consent screen. 
    {
  "invitations": [
    {
      "id": "adi_019cf7652d3f7fef8379529937af508c",
      "agentId": "agt_019cd1798d637a4da75dce386343931d",
      "status": "PENDING",
      "permissions": ["payments.create"],
      "expiresAt": "2026-02-07T00:00:00Z"
    }
  ],
  "emailFailures": []
}
  3. Customer receives email with the consent link.
  1. Create redirect URL in Settings → Redirect URLs
  2. Embed link in your application: 
    https://www.natural.co/login?redirect_url=YOUR_REDIRECT_URL
  3. Customer onboards - They complete the standard account creation flow
  4. Accept delegation - Customers accept delegation to your agent

​
Example flow

Alice (Developer)
  └─ Created agent: "Carrier Payment Agent"
  └─ Sends invitation to bruce@propertymanagement.com

Bruce (Business)
  └─ Receives email
  └─ Completes onboarding
  └─ Accepts Alice's agent delegation

Alice receives webhook:
  └─ party.kyc-status: VERIFIED
  └─ Agent can now send payments on behalf of Bruce

​
Next step

Send Payment

Execute your first payment