Skip to main content
POST
cURL
Deprecated: This endpoint bypasses validation checks and should only be used for special migration scenarios. Use the standard Add endpoint instead.
Adds a downstream entity directly without performing standard validation checks.

Headers

idempotency-key
string

UUID to ensure idempotent request processing

Example:

"550e8400-e29b-41d4-a716-446655440000"

x-idempotency-key
string

Alternative UUID header for idempotent request processing

Example:

"550e8400-e29b-41d4-a716-446655440000"

Body

application/json
firstName
string
required

First name of the primary contact

Example:

"Jon"

lastName
string
required

Last name of the primary contact

Example:

"Doe"

email
string
required

Email address of the primary contact

Example:

"example@test.com"

isNpnRequired
boolean
required

Whether NPN is required for this downstream entity

Example:

true

category
enum<string>
required

Category of the downstream entity

Available options:
agency,
agency network,
wholesale brokerage,
third party administrator
Example:

"agency"

downstreamEntityNpn
string

National Producer Number (NPN) of the downstream entity. Required when isNpnRequired is true.

Example:

"12345678"

branchName
string

Branch name. Required when parentProducerCode is provided.

Example:

"West Coast Branch"

downstreamEntityName
string

Name of the downstream entity. Required when NPN is not provided.

Example:

"ABC Insurance Agency"

producerCode
string

Producer code for this downstream entity

Example:

"PROD-001"

externalId
string

External identifier for integration purposes

Example:

"EXT-12345"

parentProducerCode
string

Producer code of the parent entity (for branch relationships)

Example:

"PARENT-001"

parentDownstreamEntityAssociationId
string

Parent downstream entity association ID (for branch relationships)

Example:

"507f1f77bcf86cd799439011"

ein
string

Federal Employer Identification Number (EIN/FEIN)

Example:

"12-3456789"

Response

Downstream entity added (deprecated)

data
object
required
requestId
string
required

Unique request identifier

Example:

"dev-2c5e7cf2-9acf-4c8c-ab2f-b81f39d775a8"

timestamp
string
required

Response timestamp

Example:

"2025-11-12T20:49:03.293Z"