Create Case

Create case with optional nested persons/vehicles/items in single atomic request.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Case creation payload (POST /incidents).

Field Categories

Read-Only Fields (Ignored if Sent):

  • incident_number - AutoNumber field (format: C-{number})
  • total_estimated_value - Roll-up from Case Items
  • total_recovered_value - Roll-up from recovered Case Items
  • Audit fields: created_date, last_modified_date, etc.

Date/Time Handling:

  • Preferred: incident_local_date + incident_local_time (separate fields)
  • Alternative: incident_date_time (ISO 8601 combined)
  • Default: If only date provided, time = midnight

Record Type:

  • Determined by the integration user's default Case record type
  • record_type is not accepted in the payload

Location Fields (Lookup Precedence):

  • location_number - External identifier (for lookup)
  • location_id - Direct Salesforce ID
  • Rule: If both provided, location_id takes precedence

Value Fields:

  • initial_case_value - Writable estimate at creation
  • Total case value auto-calculated from Case Items (read-only)

Extensibility: Field mappings configured via Custom Metadata (DomainMapping__mdt). Additional fields beyond spec will be processed per your org's config.

string
string
string
length ≤ 32000
string
string

External identifier for Location

string
string
string
date

Date in YYYY-MM-DD format (RFC3339 full-date)

string

Local time in HH:MM:SS with optional milliseconds separated by a colon (e.g., "14:30:00" or "14:30:00:123"). No timezone suffix.

date

Date in YYYY-MM-DD format (RFC3339 full-date)

string

Local time in HH:MM:SS with optional milliseconds separated by a colon (e.g., "14:30:00" or "14:30:00:123"). No timezone suffix.

string
length ≤ 25
string
length ≤ 100
string
length ≤ 50
string

Case stage (accepted in POST/PATCH, never returned in GET)

string

Case source (accepted in POST/PATCH, never returned in GET)

string

Case outcome (accepted in POST/PATCH, never returned in GET)

string

Incident category (accepted in POST/PATCH, never returned in GET)

string

Incident location (accepted in POST/PATCH, never returned in GET)

number

Initial case value (accepted in POST/PATCH, never returned in GET)

number

Total recovered value (accepted in POST/PATCH, never returned in GET)

date-time

ISO 8601 date-time (RFC3339)

date-time

ISO 8601 date-time (RFC3339)

date-time

ISO 8601 date-time (RFC3339)

string

Police officer badge number (accepted in POST/PATCH, never returned in GET)

boolean

Whether police were notified (accepted in POST/PATCH, never returned in GET)

string

Case owner User/Queue Id (15/18 chars). If omitted, defaults to integration user.

string

Investigator (accepted in POST/PATCH, never returned in GET)

string

Case priority (accepted in POST/PATCH, never returned in GET)

string

External system ID (accepted in POST/PATCH, never returned in GET)

string

External owner (accepted in POST/PATCH, never returned in GET)

involved_persons
array of objects
involved_persons
vehicles
array of objects
vehicles
stolen_items
array of objects
stolen_items
Headers
string
enum

Data source for special processing (e.g., FlockSafety)

Allowed:
string
required
Defaults to 1.0

API version

Responses

Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json