Skip to main content
POST
/
v1
/
downstream-entity-associations
/
dangerously-invite
cURL
curl --request POST \
  --url https://public.api.live.turrisfi.com/v1/downstream-entity-associations/dangerously-invite \
  --header 'Content-Type: application/json' \
  --data '
{
  "useInviteUrl": false,
  "isNpnRequired": true,
  "downstreamEntityName": "ABC Insurance Agency",
  "firstName": "John",
  "lastName": "Doe",
  "email": "john.doe@example.com",
  "category": "agency",
  "producerCode": "PROD-001",
  "externalId": "EXT-12345",
  "contractContainerTemplateId": "507f1f77bcf86cd799439011",
  "producerAgreementId": "<string>",
  "parentProducerCode": "PARENT-001",
  "customFields": {
    "customField1": "value1",
    "customField2": 123
  },
  "customFieldValues": {
    "commission_rate": 10,
    "effective_date": "2026-06-01"
  }
}
'
{
  "data": {
    "url": "<string>"
  },
  "requestId": "dev-2c5e7cf2-9acf-4c8c-ab2f-b81f39d775a8",
  "timestamp": "2025-11-12T20:49:03.293Z"
}
Deprecated: This endpoint bypasses validation checks and should only be used for special migration scenarios. Use the standard Invite endpoint instead.
Sends an invitation to a downstream entity 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
ā€‹
useInviteUrl
boolean
required

If true, returns an invite URL instead of sending an email

Example:

false

ā€‹
isNpnRequired
boolean
required

Whether NPN is required for this downstream entity

Example:

true

ā€‹
downstreamEntityName
string
required

Name of the downstream entity

Example:

"ABC Insurance Agency"

ā€‹
firstName
string
required

First name of the primary contact

Example:

"John"

ā€‹
lastName
string
required

Last name of the primary contact

Example:

"Doe"

ā€‹
email
string
required

Email address of the primary contact

Example:

"john.doe@example.com"

ā€‹
category
enum<string>
required

Category of the downstream entity

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

"agency"

ā€‹
producerCode
string

Producer code for this downstream entity

Example:

"PROD-001"

ā€‹
externalId
string

External identifier for integration purposes

Example:

"EXT-12345"

ā€‹
contractContainerTemplateId
string

ContractContainer template ID to associate with this invitation. Obtain via GET /v1/contract-container-templates. Preferred over the legacy producerAgreementId field.

Example:

"507f1f77bcf86cd799439011"

ā€‹
producerAgreementId
string
deprecated

Deprecated: use contractContainerTemplateId instead. Legacy producer-agreement file-document ID. Still accepted for backward compatibility; the ID is internally resolved to the matching ContractContainer template.

ā€‹
onboardingSettings
object

Onboarding settings to customize the onboarding flow

ā€‹
parentProducerCode
string

Producer code of the parent entity (for branch relationships)

Example:

"PARENT-001"

ā€‹
customFields
object

Custom fields for additional data

Example:
{
  "customField1": "value1",
  "customField2": 123
}
ā€‹
customFieldValues
object

Values to populate the contract template custom fields. Keyed by fieldName. Required when the selected contractContainerTemplateId has customFields defined; the values are validated against type / required / min / max.

Example:
{
  "commission_rate": 10,
  "effective_date": "2026-06-01"
}

Response

Downstream entity invitation sent (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"