POST v1/Agents

Create Agent

Request Information

URI Parameters

None.

Body Parameters

Agent info

CreateAgentDTO
NameDescriptionTypeAdditional information
Password

string

Required

Username

string

Required

String length: inclusive between 0 and 100

Email

string

Required

GroupMemberships

Collection of string

None.

ExternalId

Identifier external to the DRC System; a custom Id

string

String length: inclusive between 0 and 30

ProducerCode

Producer code

string

String length: inclusive between 0 and 50

FirstName

string

String length: inclusive between 0 and 30

LastName

string

String length: inclusive between 0 and 30

CommercialName

Legal Name

string

String length: inclusive between 0 and 500

AgencyName

string

String length: inclusive between 0 and 500

Role

Primary role of the agency. Changing the value of this field after the initial create request is highly unusual and should not be done without caution.

AgentPrimaryRoleEnum

None.

OrganizationIds

Ids of the organizations the agency belongs to

Collection of integer

None.

ParentAgencyId

integer

None.

ParentAgency

AgencyDTO

None.

IsActive

Indicates if the agency's user account is currently activated

boolean

Required

Commissions

Collection of AgentCommissionDTO

None.

Licenses

Collection of AgentLicenseDTO

None.

ErrorsAndOmissions

Collection of AgentErrorAndOmissionDTO

None.

Id

Primary Id

integer

None.

Request Formats

application/json, text/json

Sample:
{
  "Password": "sample string 1",
  "Username": "sample string 2",
  "Email": "sample string 3",
  "GroupMemberships": [
    "sample string 1",
    "sample string 2"
  ],
  "ExternalId": "sample string 4",
  "ProducerCode": "sample string 5",
  "FirstName": "sample string 6",
  "LastName": "sample string 7",
  "CommercialName": "sample string 8",
  "AgencyName": "sample string 9",
  "Role": "Unknown",
  "OrganizationIds": [
    1,
    2
  ],
  "ParentAgencyId": 1,
  "ParentAgency": {
    "CommissionCalcType": "Unknown",
    "Agency1099Type": "Unknown",
    "Reportable1099": true,
    "TaxIdType": "Unknown",
    "TaxId": "sample string 1",
    "IRSControlNumber": "sample string 2",
    "ExemptPayeeCode": "sample string 3",
    "VendorId": "sample string 4",
    "W9Address": {
      "Type": "Unknown",
      "Address1": "sample string 1",
      "Address2": "sample string 2",
      "City": "sample string 3",
      "State": "sample string 4",
      "County": "sample string 5",
      "Country": "sample string 6",
      "Zipcode1": "sample string 7",
      "Zipcode2": "sample string 8",
      "Id": 9
    },
    "LocationAddress": {
      "Type": "Unknown",
      "Address1": "sample string 1",
      "Address2": "sample string 2",
      "City": "sample string 3",
      "State": "sample string 4",
      "County": "sample string 5",
      "Country": "sample string 6",
      "Zipcode1": "sample string 7",
      "Zipcode2": "sample string 8",
      "Id": 9
    },
    "MailingAddress": {
      "Type": "Unknown",
      "Address1": "sample string 1",
      "Address2": "sample string 2",
      "City": "sample string 3",
      "State": "sample string 4",
      "County": "sample string 5",
      "Country": "sample string 6",
      "Zipcode1": "sample string 7",
      "Zipcode2": "sample string 8",
      "Id": 9
    },
    "PayDirect": true,
    "AgencyBill": true,
    "AgencyBillType": "Unknown",
    "ExternalId": "sample string 5",
    "ProducerCode": "sample string 6",
    "FirstName": "sample string 7",
    "LastName": "sample string 8",
    "CommercialName": "sample string 9",
    "AgencyName": "sample string 10",
    "Email": "sample string 11",
    "Role": "Unknown",
    "OrganizationIds": [
      1,
      2
    ],
    "ParentAgencyId": 1,
    "IsActive": true,
    "Commissions": [
      {
        "EffectiveDate": "2024-03-28T02:04:09.406885-10:00",
        "ExpirationDate": "2024-03-28T02:04:09.406885-10:00",
        "Type": "Unknown",
        "Rate": 1.0,
        "LineOfBusiness": "sample string 1",
        "State": "sample string 2",
        "Country": "sample string 3",
        "CommissionOverrideCalcType": "Unknown",
        "UnderwritingCompanyId": 4,
        "PolicyClassification": "Unknown",
        "NewOrRenewal": "New",
        "Partner": "Unknown",
        "ChannelType": "Unknown",
        "CommissionOverride": true,
        "Id": 6
      },
      {
        "EffectiveDate": "2024-03-28T02:04:09.406885-10:00",
        "ExpirationDate": "2024-03-28T02:04:09.406885-10:00",
        "Type": "Unknown",
        "Rate": 1.0,
        "LineOfBusiness": "sample string 1",
        "State": "sample string 2",
        "Country": "sample string 3",
        "CommissionOverrideCalcType": "Unknown",
        "UnderwritingCompanyId": 4,
        "PolicyClassification": "Unknown",
        "NewOrRenewal": "New",
        "Partner": "Unknown",
        "ChannelType": "Unknown",
        "CommissionOverride": true,
        "Id": 6
      }
    ],
    "Licenses": [
      {
        "LicenseNumber": "sample string 1",
        "State": "sample string 2",
        "LicenseTypeId": 3,
        "EffectiveDate": "2024-03-28T02:04:09.406885-10:00",
        "ExpirationDate": "2024-03-28T02:04:09.406885-10:00",
        "Id": 4
      },
      {
        "LicenseNumber": "sample string 1",
        "State": "sample string 2",
        "LicenseTypeId": 3,
        "EffectiveDate": "2024-03-28T02:04:09.406885-10:00",
        "ExpirationDate": "2024-03-28T02:04:09.406885-10:00",
        "Id": 4
      }
    ],
    "ErrorsAndOmissions": [
      {
        "EffectiveDate": "2024-03-28T02:04:09.406885-10:00",
        "ExpirationDate": "2024-03-28T02:04:09.406885-10:00",
        "PolicyNumber": "sample string 1",
        "ErrorAndOmissionsCompanyId": 2,
        "Id": 3
      },
      {
        "EffectiveDate": "2024-03-28T02:04:09.406885-10:00",
        "ExpirationDate": "2024-03-28T02:04:09.406885-10:00",
        "PolicyNumber": "sample string 1",
        "ErrorAndOmissionsCompanyId": 2,
        "Id": 3
      }
    ],
    "Id": 12
  },
  "IsActive": true,
  "Commissions": [
    {
      "EffectiveDate": "2024-03-28T02:04:09.406885-10:00",
      "ExpirationDate": "2024-03-28T02:04:09.406885-10:00",
      "Type": "Unknown",
      "Rate": 1.0,
      "LineOfBusiness": "sample string 1",
      "State": "sample string 2",
      "Country": "sample string 3",
      "CommissionOverrideCalcType": "Unknown",
      "UnderwritingCompanyId": 4,
      "PolicyClassification": "Unknown",
      "NewOrRenewal": "New",
      "Partner": "Unknown",
      "ChannelType": "Unknown",
      "CommissionOverride": true,
      "Id": 6
    },
    {
      "EffectiveDate": "2024-03-28T02:04:09.406885-10:00",
      "ExpirationDate": "2024-03-28T02:04:09.406885-10:00",
      "Type": "Unknown",
      "Rate": 1.0,
      "LineOfBusiness": "sample string 1",
      "State": "sample string 2",
      "Country": "sample string 3",
      "CommissionOverrideCalcType": "Unknown",
      "UnderwritingCompanyId": 4,
      "PolicyClassification": "Unknown",
      "NewOrRenewal": "New",
      "Partner": "Unknown",
      "ChannelType": "Unknown",
      "CommissionOverride": true,
      "Id": 6
    }
  ],
  "Licenses": [
    {
      "LicenseNumber": "sample string 1",
      "State": "sample string 2",
      "LicenseTypeId": 3,
      "EffectiveDate": "2024-03-28T02:04:09.406885-10:00",
      "ExpirationDate": "2024-03-28T02:04:09.406885-10:00",
      "Id": 4
    },
    {
      "LicenseNumber": "sample string 1",
      "State": "sample string 2",
      "LicenseTypeId": 3,
      "EffectiveDate": "2024-03-28T02:04:09.406885-10:00",
      "ExpirationDate": "2024-03-28T02:04:09.406885-10:00",
      "Id": 4
    }
  ],
  "ErrorsAndOmissions": [
    {
      "EffectiveDate": "2024-03-28T02:04:09.406885-10:00",
      "ExpirationDate": "2024-03-28T02:04:09.406885-10:00",
      "PolicyNumber": "sample string 1",
      "ErrorAndOmissionsCompanyId": 2,
      "Id": 3
    },
    {
      "EffectiveDate": "2024-03-28T02:04:09.406885-10:00",
      "ExpirationDate": "2024-03-28T02:04:09.406885-10:00",
      "PolicyNumber": "sample string 1",
      "ErrorAndOmissionsCompanyId": 2,
      "Id": 3
    }
  ],
  "Id": 10
}

application/xml

Sample:

Sample not available.

text/xml

Sample:

Sample not available.

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

IdResponseDTO
NameDescriptionTypeAdditional information
Id

Primary Id

integer

None.

WarningMessages

List of warning messages encountered while servicing request

Collection of string

None.

Response Formats

application/json, text/json

Sample:

Sample not available.