Attorney.Create
Endpoint
- Method:
POST - Route:
Attorney/Create - Authentication:
Authorize
Request Schema
Headers
| Header | Required | Notes |
|---|---|---|
X-Api-Key |
Required when tenant is not resolved by subdomain | Resolves the tenant/customer database. |
Authorization: Bearer {token} |
Required for authorized endpoints | Get a token from Auth/Token or Session/Create. |
JSON Body
Body type: AttorneyWriteRequestDto
| Field | Type | Required | Notes |
|---|---|---|---|
attorney |
string |
Yes | Attorney/adjuster display name. |
barNumber |
string |
Yes | State bar number. Used as the upsert key for the authenticated customer. |
title |
string |
No | Title or role label. |
email |
string |
No | Email address. |
phone |
string |
No | Phone number. |
secretary |
string |
No | Secretary name. |
salutation |
string |
No | Salutation. |
signature |
string |
No | Signature file name when configured. |
retired |
bool |
No | Marks the attorney as retired when true. |
When a record with the same barNumber already exists for the authenticated customer, the API updates that attorney instead of creating a duplicate.
Request Sample
{
"attorney": "Jane Attorney",
"barNumber": "CA123456",
"title": "Attorney",
"email": "jane.attorney@example.com",
"phone": "2135550100",
"retired": false
}
Expected Response Schema
Status Codes
| Status | Notes |
|---|---|
200 OK |
Attorney created or updated. |
400 Bad Request |
Required fields are missing or invalid. |
Success Body
Response type: AttorneyEntity
| Field | Type | Notes |
|---|---|---|
customerCode |
string |
Customer code that owns the attorney. |
code |
int |
Attorney code to send on order create/export. Use as adjusterCode for Court/Process/Delivery/FileAndServe, attorney for PhotoCopy, or attorneyCode for Investigation. |
barNumber |
string |
State bar number. |
attorney |
string |
Attorney display name. |
title |
string |
Title or role label. |
email |
string |
Email address. |
phone |
string |
Phone number. |
retired |
bool |
Whether the attorney is retired. |
Response Sample
{
"customerCode": "ABC001",
"code": 123,
"barNumber": "CA123456",
"attorney": "Jane Attorney",
"title": "Attorney",
"email": "jane.attorney@example.com",
"phone": "2135550100",
"retired": false
}
Related Endpoints
Use Attorney.GetAll to list attorneys and retrieve valid code values for order create flows.