Invite a customer

from naturalpay import Natural

client = Natural()
invitations = client.customers.create_invitations(
    recipients=[{"type": "email", "value": "customer@example.com"}],
    agents=[
        {
            "agentId": "agt_019cd1798d637a4da75dce386343931d",
            "permissions": [
                "payments.read",
                "payments.create",
                "external_accounts.create",
                "wallets.read",
                "wallets.update",
                "party.read",
                "party.update",
            ],
            "limits": {"perTransaction": 100_000},
        }
    ],
)

for invitation in invitations.data:
    print(invitation.id, invitation.attributes.url)

import Natural from "@naturalpay/sdk";

const client = new Natural();
const invitations = await client.customers.createInvitations({
  recipients: [{ type: "email", value: "customer@example.com" }],
  agents: [
    {
      agentId: "agt_019cd1798d637a4da75dce386343931d",
      permissions: [
        "payments.read",
        "payments.create",
        "external_accounts.create",
        "wallets.read",
        "wallets.update",
        "party.read",
        "party.update",
      ],
      limits: { perTransaction: 100_000 },
    },
  ],
});

for (const invitation of invitations.data) {
  console.log(invitation.id, invitation.attributes.url);
}

natural customers createInvitations --json '{
  "recipients": [{ "type": "email", "value": "customer@example.com" }],
  "agents": [{
    "agentId": "agt_019cd1798d637a4da75dce386343931d",
    "permissions": ["payments.read", "payments.create", "external_accounts.create", "wallets.read", "wallets.update", "party.read", "party.update"],
    "limits": { "perTransaction": 100000 }
  }]
}'

Invite customer@example.com to connect my Procurement Agent.
Let it run money end to end for them, limited to $1,000 per transaction.

curl -X POST https://api.natural.com/customers/invitations \
  -H "Authorization: Bearer $NATURAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "data": {
      "attributes": {
        "recipients": [{ "type": "email", "value": "customer@example.com" }],
        "agents": [{
          "agentId": "agt_019cd1798d637a4da75dce386343931d",
          "permissions": ["payments.read", "payments.create", "external_accounts.create", "wallets.read", "wallets.update", "party.read", "party.update"],
          "limits": { "perTransaction": 100000 }
        }]
      }
    }
  }'