Create carrier

📘

API Refs

This endpoint creates a new carrier in your agency's account. Each carrier must have contact information, business details, and a physical address.

Request body

NameTypeDescriptionRequired
firstNamestringFirst name of the carrier contact (max 255 characters)yes
lastNamestringLast name of the carrier contact (max 255 characters)yes
businessNamestringBusiness name of the carrier (max 255 characters)yes
emailstringPrimary contact email addressyes
commissionnumberCommission percentage (e.g., 15.0 for 15%)yes
addressobjectPhysical address informationyes

Address object

NameTypeDescriptionRequired
address1stringPrimary address lineyes
address2stringSecondary address lineno
citystringCity nameyes
statestringTwo-letter US state codeyes
postalCodestring5-digit postal codeyes
phonestringContact phone numberyes
aliasstringReference name for this addressyes

Response

NameTypeDescription
idnumberUnique carrier identifier
namestringCarrier business name
emailstringPrimary contact email
commissionnumberCommission percentage

Example

{
  "firstName": "John",
  "lastName": "Smith",
  "businessName": "ABC Insurance Co",
  "email": "[email protected]",
  "commission": 15.0,
  "address": {
    "address1": "123 Main St",
    "address2": "Suite 100",
    "city": "Chicago",
    "state": "IL",
    "postalCode": "60601",
    "phone": "312-555-0123",
    "alias": "main-office"
  }
}
📘

Note

The commission rate cannot be modified through the API after creation. Any changes to commission rates must be made through the AgentSnap dashboard.

❗️

Important: The business name must be unique within your agency's account.