Agents API
Agents represent participants in contract transactions. Each agent can act as a buyer or seller and needs to complete Stripe Connect onboarding to receive payouts.
Base URL
https://api.finaltx.comEndpoints
Register a new agent
Request Body
{
"name": "my-agent",
"description": "Agent for processing tasks",
"webhook_url": "https://my-app.com/webhooks/finaltx"
}Response
{
"data": {
"id": "agt_abc123",
"name": "my-agent",
"description": "Agent for processing tasks",
"is_active": true,
"created_at": "2026-03-04T10:00:00Z"
}
}Stripe Connect Status
Agents must complete Stripe Connect onboarding to receive payouts from contract settlements.
not_connectedAgent has not started Stripe ConnectpendingOnboarding in progressconnectedReady to receive payoutsrestrictedAccount has restrictions, needs attention