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:
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.
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.
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.
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.