Assign a Producer to Entities

Assign a producer to entities

curl --request POST \
  --url https://public.api.live.turrisfi.com/v2/downstream/producers/{producerId}/entities \
  --header 'Content-Type: application/json' \
  --data '
{
  "entityIds": [
    "6610b3d2c2e0a51b8c0d1f02"
  ],
  "email": "example@test.com",
  "tel": "+12155550100",
  "position": "Producer",
  "drlpStates": [
    "PA"
  ]
}
'

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    entityIds: ['6610b3d2c2e0a51b8c0d1f02'],
    email: 'example@test.com',
    tel: '+12155550100',
    position: 'Producer',
    drlpStates: ['PA']
  })
};

fetch('https://public.api.live.turrisfi.com/v2/downstream/producers/{producerId}/entities', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://public.api.live.turrisfi.com/v2/downstream/producers/{producerId}/entities"

payload = {
    "entityIds": ["6610b3d2c2e0a51b8c0d1f02"],
    "email": "example@test.com",
    "tel": "+12155550100",
    "position": "Producer",
    "drlpStates": ["PA"]
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "data": {
    "producerId": "6627f2b5c2e0a51b8c0d4e7c",
    "firstName": "Jon",
    "lastName": "Doe",
    "entities": [
      {
        "associationId": "6627f1a9c2e0a51b8c0d4e3a",
        "downstreamEntityId": "6610b3d2c2e0a51b8c0d1f02",
        "branchName": "Philadelphia Branch",
        "drlpStates": [
          "PA"
        ],
        "email": "example@test.com",
        "position": "Producer"
      }
    ],
    "middleName": "R",
    "npn": "7654321",
    "mainEmail": "example@test.com",
    "nasdCrd": "5551234",
    "createdAt": "2025-01-15T10:30:00.000Z",
    "updatedAt": "2025-06-02T08:12:44.000Z"
  },
  "requestId": "dev-2c5e7cf2-9acf-4c8c-ab2f-b81f39d775a8",
  "timestamp": "2025-11-12T20:49:03.293Z"
}

{
  "statusCode": 123,
  "requestId": "<string>",
  "errorType": "validation_error",
  "errorMessage": [
    "<string>"
  ],
  "timestamp": "<string>",
  "details": {}
}

{
  "statusCode": 123,
  "requestId": "<string>",
  "errorType": "validation_error",
  "errorMessage": [
    "<string>"
  ],
  "timestamp": "<string>",
  "details": {}
}

{
  "statusCode": 123,
  "requestId": "<string>",
  "errorType": "validation_error",
  "errorMessage": [
    "<string>"
  ],
  "timestamp": "<string>",
  "details": {}
}

{
  "statusCode": 123,
  "requestId": "<string>",
  "errorType": "validation_error",
  "errorMessage": [
    "<string>"
  ],
  "timestamp": "<string>",
  "details": {}
}

POST

downstream

producers

{producerId}

entities

Assign a producer to entities

curl --request POST \
  --url https://public.api.live.turrisfi.com/v2/downstream/producers/{producerId}/entities \
  --header 'Content-Type: application/json' \
  --data '
{
  "entityIds": [
    "6610b3d2c2e0a51b8c0d1f02"
  ],
  "email": "example@test.com",
  "tel": "+12155550100",
  "position": "Producer",
  "drlpStates": [
    "PA"
  ]
}
'

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    entityIds: ['6610b3d2c2e0a51b8c0d1f02'],
    email: 'example@test.com',
    tel: '+12155550100',
    position: 'Producer',
    drlpStates: ['PA']
  })
};

fetch('https://public.api.live.turrisfi.com/v2/downstream/producers/{producerId}/entities', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://public.api.live.turrisfi.com/v2/downstream/producers/{producerId}/entities"

payload = {
    "entityIds": ["6610b3d2c2e0a51b8c0d1f02"],
    "email": "example@test.com",
    "tel": "+12155550100",
    "position": "Producer",
    "drlpStates": ["PA"]
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "data": {
    "producerId": "6627f2b5c2e0a51b8c0d4e7c",
    "firstName": "Jon",
    "lastName": "Doe",
    "entities": [
      {
        "associationId": "6627f1a9c2e0a51b8c0d4e3a",
        "downstreamEntityId": "6610b3d2c2e0a51b8c0d1f02",
        "branchName": "Philadelphia Branch",
        "drlpStates": [
          "PA"
        ],
        "email": "example@test.com",
        "position": "Producer"
      }
    ],
    "middleName": "R",
    "npn": "7654321",
    "mainEmail": "example@test.com",
    "nasdCrd": "5551234",
    "createdAt": "2025-01-15T10:30:00.000Z",
    "updatedAt": "2025-06-02T08:12:44.000Z"
  },
  "requestId": "dev-2c5e7cf2-9acf-4c8c-ab2f-b81f39d775a8",
  "timestamp": "2025-11-12T20:49:03.293Z"
}

{
  "statusCode": 123,
  "requestId": "<string>",
  "errorType": "validation_error",
  "errorMessage": [
    "<string>"
  ],
  "timestamp": "<string>",
  "details": {}
}

{
  "statusCode": 123,
  "requestId": "<string>",
  "errorType": "validation_error",
  "errorMessage": [
    "<string>"
  ],
  "timestamp": "<string>",
  "details": {}
}

{
  "statusCode": 123,
  "requestId": "<string>",
  "errorType": "validation_error",
  "errorMessage": [
    "<string>"
  ],
  "timestamp": "<string>",
  "details": {}
}

{
  "statusCode": 123,
  "requestId": "<string>",
  "errorType": "validation_error",
  "errorMessage": [
    "<string>"
  ],
  "timestamp": "<string>",
  "details": {}
}

Associates a producer you already work with to additional entities in your subtree.

Already-associated entities are skipped, not rejected

Unlike Add a Producer, sending an entity the producer is already on is not an error. The two requests mean different things: “create this person” twice is a mistake worth a 409, while “make sure they are on these entities” twice is the same instruction, and a caller adding one branch to a list of five should not have to diff the list first.

Scope

The producer must already be associated with at least one entity in your subtree, or the request returns 404 — you cannot pull an arbitrary producer id off the platform into your organization. Every id in entityIds must be in your subtree as well. Send an Idempotency-Key header. See Idempotency.

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"

Path Parameters

producerId

string

required

The unique identifier of the producer (the producerId returned by the List Producers endpoint).

Example:

"6627f2b5c2e0a51b8c0d4e7c"

Body

application/json

entityIds

array[]

required

The entities to associate the producer with. Ids the producer is already associated with are skipped rather than duplicated, so the request is safe to repeat.

Example:

["6610b3d2c2e0a51b8c0d1f02"]

string

Contact email on the new associations

Example:

"example@test.com"

tel

string

Contact phone number on the new associations

Example:

"+12155550100"

position

string

Job title on the new associations

Example:

"Producer"

drlpStates

enum<string>[]

States where this producer is a Designated Responsible Licensed Producer for the new associations.

Available options:

AL,

AK,

AZ,

AR,

CA,

CO,

CT,

DE,

FL,

GA,

HI,

ID,

IL,

IN,

IA,

KS,

KY,

LA,

ME,

MD,

MA,

MI,

MN,

MS,

MO,

MT,

NE,

NV,

NH,

NJ,

NM,

NY,

NC,

ND,

OH,

OK,

OR,

PA,

RI,

SC,

SD,

TN,

TX,

UT,

VT,

VA,

WA,

WV,

WI,

WY,

GU,

PR,

VI,

DC

Example:

["PA"]

Response

The producer, with its entities

data

object

required

Show child attributes

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"

Start Here

Shared Endpoints

Licensed Entities

Producers

Contacts

Licenses

Actions Required

Licensing Overview

Appointments

License Requests

Compliance Configurations

Markets

Corporate Registrations

Documents

Surplus Lines

Already-associated entities are skipped, not rejected

Scope

Headers

Path Parameters

Body

Response

​Already-associated entities are skipped, not rejected

​Scope

Headers

Path Parameters

Body

Response

Already-associated entities are skipped, not rejected

Scope