Create Transaction
Create a transaction under an existing policy
policyNumber is inherited from the parent policy. Only policyTransactionDate and riskStateCode are required. policyTransactionType defaults to bound when omitted.
Path Parameters
Agent Assignment
agentIds (agent _id values from List Agents) is only valid when the parent policy has a confirmed agency match. Each agent must be available to the matched agency, otherwise the request fails with 422.
uniqueTransactionId to give the transaction a stable, caller-supplied id that disambiguates otherwise-identical transactions during deduplication.Response Shape
Error Scenarios
Bad Request (400)
Returned whenpolicyId is malformed or the body fails validation.
Parent Policy Not Found (404)
Returned whenpolicyId does not exist or belongs to a different upstream entity.
Duplicate Transaction (409)
Returned when a transaction with these details already exists under the policy.Agent Assignment Rejected (422)
Returned whenagentIds is supplied without a confirmed agency, or an agent is not available to the matched agency.
Unauthorized (401)
Missing or invalid authentication token. See Authentication.Idempotency
This endpoint supports idempotency. If you include anidempotency-key header, duplicate requests within 1 hour return the original response without creating a second transaction. See Idempotency.Headers
UUID to ensure idempotent request processing
"550e8400-e29b-41d4-a716-446655440000"
Alternative UUID header for idempotent request processing
"550e8400-e29b-41d4-a716-446655440000"
Path Parameters
Unique identifier of the parent policy
"6650a1b2c3d4e5f6a7b8c9d0"
Body
Transaction date (ISO 8601)
"2025-01-15T00:00:00.000Z"
US state code where the risk is located
"CA"
Transaction type. Defaults to "bound" when omitted.
new, renewal, endorsement, cancellation, audit, reinstatement, bound "new"
Caller-supplied stable id disambiguating otherwise-identical transactions during dedup.
"ext-txn-001"
Name of the insured party
"Example Corp"
Agency name
"Premier Insurance Agency"
Insurance carrier name
"National Insurance Co"
Effective date (ISO 8601)
"2025-01-15T00:00:00.000Z"
Expiration date (ISO 8601)
"2026-01-15T00:00:00.000Z"
Premium amount in USD
5000
Aggregate coverage limit in USD
1000000
Per-claim coverage limit in USD
500000
Line of business
"Commercial Lines"
License number
"LIC-001"
National Producer Number
"11223344"
Producing agent name
"Jon Doe"
Producer identifier code
"PROD-001"
Product name
"General Liability"
Product code
"GL-100"
Filing number
"FIL-2025-001"
SLA number
"SLA-2025-001"
External billing identifier
"BILL-2025-001"
Agency National Producer Number
"12345678"
Agency Federal Employer Identification Number
"12-3456789"
Agency state license number
"ABC-123456"
State where the agency license was issued
"CA"
Individual agent name
"John Smith"
Agent National Producer Number
"87654321"
Agent state license number
"LIC-789012"
State where the agent license was issued
"TX"
Agent association - agent ids (agent._id from GET /agents) to assign. Requires a confirmed agency.