Skip to main content
A party is Natural’s representation of a real-world identity. It ties together your Agents, Wallets, and the authorization you grant through Natural Connect. There are two types of party: Individuals and Businesses. Most developers sign up as a Business so they can invite teammates. Every party clears Compliance (KYB for businesses, KYC for individuals).

​
Handles

Every party can claim a handle, the @name other parties use to pay or request money from you without knowing an email, phone number, or party ID. Agents get composed handles under their party (@acme-support), so a handle also names who an agent acts for. Claim or rename your handle in the dashboard, or with PUT /parties/me/handle. Handles cannot be cleared: every party keeps one once claimed. Handle changes are reserved for signed-in users on a verified party; API keys and agents cannot change a handle. Renaming releases the previous name into a 14-day hold, during which only your party can take it back.

​
Canonical examples

Throughout our documentation, we use these three parties as canonical examples:

​
Kendall Developer (Business Party)

Kendall is an AI agent developer who has integrated Natural into his AI property management platform. He:
  • Uses agents to automate vendor and contractor payments
  • Uses Natural to allow his agents to pay his customers

​
Eric Customer (Business Party)

Eric runs a property management company and uses Kendall’s agents. He:
  • Onboards as Kendall’s customer through Natural Connect and authorizes Kendall’s agents to pay on his behalf
  • Uses Kendall’s agents to pay vendors and contractors automatically

​
Klaire Contractor (Individual Party)

Klaire is a plumber who receives payments from businesses. She:
  • Is sent money by Kendall’s agents on behalf of Eric
  • Signs up to claim her first payment from Eric