Producers

Learn the relationship between your platform, a producer, and insurance products.

A producer is typically an agent or broker authorized to distribute an insurance product on behalf of one or more insurance carriers (also known as institutions). Each licensed agent on your platform is a producer, and would be given a unique [.h-code]producer_id[.h-code]. Each producer must be appointed and authorized to sell a product from a carrier.

We use [.h-code]producer_id[.h-code] for 2 main purposes:

  1. To manage producers’ carrier and product access
  2. To attribute sales to the right producers

Today, producers are registered manually by Herald. Each producer can have access to multiple products, as long as they are authorized to access them by the carrier. A producer may be associated with multiple platforms, and having access to a product on one platform does not give them access to the same product on another platform. A [.h-code]producer_id[.h-code] is required when submitting applications in order for us to identify which individual licensed agent is requesting the insurance, and to confirm that they have access to the products they are trying to use.

Setting up a producer

Herald does all the work to set up producers. To register a new producer, send us an email with their name, email, agency, and office. A producer has to be given access to each individual product, and depending on the carrier, we may follow up for additional information that the carrier requires (e.g., a producer ID assigned to the broker from the carrier). Then we will manually register your producers in our system.

[.icon-circle-blue][.icon-circle-blue]We do not directly offer or facilitate carrier appointments for individual producers, but we are always more than happy to make organization-level introductions for your brokerage or platform if you are interested in working with a new carrier partner in our network.

Managing producers

  • Adding producers: Email us with the same information above for your new producer or producers, and if required by carriers we will request additional details.
  • Changing producer product access: To give a producer access to a new product, or to revoke access to a product they can currently access, email us the desired change and we will let you know if we need any further information before confirming the update.

Using producers

When submitting an application, a [.h-code]producer_id[.h-code] is required. If the producer doesn’t have access to one or more of the products, you’ll receive a [.h-code]400[.h-code] error like the example below.

Copied

"errors": [
   {
     "code": "invalid_format",
     "message": "The following Product IDs are not available for the given Producer ID: [prd_m3qr_herald_general_liability]"
   }
]
 

You can use [.h-endpoint-link]/producers[.h-endpoint-link] to get a list of all producers on your platform, or query to a specific producer using an [.h-code]external_id[.h-code]. As shown in the example below, the response will include each producers name, email, id, and an external_id if you’ve provided one.

Copied

{
  "producers": [
    {
      "id": "0aa9169f-aef1-4062-a10b-8c23aa24cd73",
      "name": "Harold Whetstone",
      "email": "harold@whetstone.io",
      "external_id": "abc_123"
    },
    {
      "id": "6a32a7c7-505f-403f-9eb1-92965f54b18b",
      "name": "Mike Samuels",
      "email": "michael.s@canoeclassinsurance.com",
      "external_id": null
    },
  ]
}