Skip to main content
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/agent-delegation-invitations \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "data": {
      "attributes": {
        "customer_email": "bruce@propertymanagement.com",
        "permissions": ["payments.create", "wallets.read"],
        "proposed_agents": [
          {
            "agent_id": "agt_019cd1798d637a4da75dce386343931d",
            "permissions": ["payments.create"]
          }
        ],
        "expires_in_days": 7
      }
    }
  }'
    Response: 
    {
  "data": {
    "type": "delegation_invitation",
    "id": "din_abc123def456",
    "attributes": {
      "customer_email": "bruce@propertymanagement.com",
      "status": "PENDING",
      "permissions": ["payments.create", "wallets.read"],
      "expires_at": "2026-02-07T00:00:00Z",
      "magic_link": "https://natural.co/dashboard/agents/authorize-delegation/abc123...",
      "created_at": "2026-01-31T00:00:00Z"
    },
    "relationships": {
      "delegated_party": {
        "data": { "type": "party", "id": "pty_your_party_id" }
      }
    }
  }
}
  3. Customer receives email with onboarding link (or use magic_link from response)
  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