Update a buyer (comprehensive CRUD)
Comprehensive buyer updates supporting:
- Core buyer fields (name, legalName, primaryEmail, primaryPhone) - phantom buyers only
- Partnership status updates (if supplier owns the partnership)
- Create, update, and delete operations for emails, phones, and locations
- Business buyers can only update partnership status (if owned)
Partnership Ownership: Only the supplier that owns the partnership can update its status. Ownership is determined by which business created the partnership.
Phantom vs Business Buyers: Phantom buyers (created via POST /buyers) support full CRUD operations. Business buyers (existing businesses) only support partnership status updates.
Headers
Business identifier for external auth. Find in Polinate app → Business Settings → Integrations.
"{{businessId}}"
Per-business API key for external auth. Find in Polinate app → Business Settings → Integrations.
"{{apiKey}}"
Idempotency key for POST operations
"{{idempotencyKey}}"
Path Parameters
"phm_123"
Body
DECLINED, PENDING, REVIEW, ACTIVE, PAUSED, SUSPENDED, EXPIRED, TERMINATED Response
OK - Returns full updated buyer with all contacts
PENDING, ACTIVE, PAUSED, TERMINATED, DECLINED, EXPIRED 
