POST Agent

New Agent records are required by external systems to for self-maintenance. This method is available only to systems requiring examiner-agent ownership. When an agent record is successfully created it will be tied to the examiner credentials used in the post.

Request Information

URI Parameters

None.

Body Parameters

Agent
NameDescriptionTypeAdditional information
AgentID

The id of the Agent in SMM's system. This property may be ommitted if this number is unknown or otherwise unavailable.

integer

None.

AgentFullName

The full name of the agent.

string

None.

FirstName

string

None.

LastName

string

None.

AddressLine1

string

None.

Suite

string

None.

City

string

None.

State

string

None.

Zip

string

None.

PhoneNumber

The main contact phone number for the agent.

string

None.

Extension

string

None.

EmailAddress

A contact method for the agency.

string

None.

CreateDate

The date the agent was created in SMM's system. If placing a new order, this property should be ommitted.

date

None.

IsActive

Whether or not the agent is active in SMM's system. If placing a new order, this property should be ommitted.

boolean

None.

Request Formats

application/json, text/json

Sample:
{
  "AgentID": 1,
  "AgentFullName": "sample string 2",
  "FirstName": "sample string 3",
  "LastName": "sample string 4",
  "AddressLine1": "sample string 5",
  "Suite": "sample string 6",
  "City": "sample string 7",
  "State": "sample string 8",
  "Zip": "sample string 9",
  "PhoneNumber": "sample string 10",
  "Extension": "sample string 11",
  "EmailAddress": "sample string 12",
  "CreateDate": "2024-09-19T04:36:49.5392104-05:00",
  "IsActive": true
}

application/xml, text/xml

Sample:
<Agent xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <AgentID>1</AgentID>
  <AgentFullName>sample string 2</AgentFullName>
  <FirstName>sample string 3</FirstName>
  <LastName>sample string 4</LastName>
  <AddressLine1>sample string 5</AddressLine1>
  <Suite>sample string 6</Suite>
  <City>sample string 7</City>
  <State>sample string 8</State>
  <Zip>sample string 9</Zip>
  <PhoneNumber>sample string 10</PhoneNumber>
  <Extension>sample string 11</Extension>
  <EmailAddress>sample string 12</EmailAddress>
  <CreateDate>2024-09-19T04:36:49.5392104-05:00</CreateDate>
  <IsActive>true</IsActive>
</Agent>

application/x-www-form-urlencoded

Sample:

Failed to generate the sample for media type 'application/x-www-form-urlencoded'. Cannot use formatter 'JQueryMvcFormUrlEncodedFormatter' to write type 'Agent'.

Response Information

Resource Description

Agency ID

TransactionResult
NameDescriptionTypeAdditional information
Log

Collection of string

None.

Status

TransactionStatus

None.

Code

string

None.

ReturnID

string

None.

TransObject

Object

None.

LogString

string

None.

Response Formats

application/json, text/json

Sample:
{
  "Log": [
    "sample string 1",
    "sample string 2"
  ],
  "Status": 0,
  "Code": "sample string 1",
  "ReturnID": "sample string 2",
  "TransObject": {},
  "LogString": "sample string 1\r\nsample string 2\r\n"
}

application/xml, text/xml

Sample:
<TransactionResult xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <Log>
    <string>sample string 1</string>
    <string>sample string 2</string>
  </Log>
  <Status>Not Yet Run</Status>
  <Code>sample string 1</Code>
  <ReturnID>sample string 2</ReturnID>
  <TransObject />
</TransactionResult>