Skip to main content
POST
Initiate New Submission

Authorizations

Authorization
string
header
required

Supports Token-prefixed API keys and Bearer-prefixed JWT-based authentication.

Body

multipart/form-data
files
string<uri>[]
required

Files to upload. Supply a single email file (.eml or .msg) to process its attachments, or one or more documents directly.

cc_emails
string<email>[]

List of email addresses to CC on email notifications for this submission.

client_ref
string | null

Client reference identifier.

expiration_date
string<date> | null

Date when the insurance policy should terminate.

inception_date
string<date> | null

Date when the insurance policy was/will be/is targeted to begin.

insured_name
string | null

Name of the insured.

is_rush
boolean
default:false

Whether this submission should be treated as a rush submission.

need_by_date
string<date> | null

Date by which the submission is needed.

new_renewal
enum<string> | null

Whether the submission is for a new policy or a renewal.

  • New - New
  • Renewal - Renewal
Available options:
New,
Renewal,
null
notify_complete
boolean
default:false

Whether to send an email notification when the submission processing is complete. Defaults to False for API submissions.

notify_received
boolean
default:false

Whether to send an email notification when the submission is received. Defaults to False for API submissions.

risk_summary
string | null

Risk summary of the insured

target_terms
string | null

Optional target terms entered by the broker/user.

team_uuid
string<uuid> | null

UUID of the team to which the submission should be sent. Required if the API user has access to create submissions for multiple teams.

underwriter_email
string<email> | null

Email address of the underwriter.

underwriter_name
string | null

Name of the underwriter.

workflow
string | null

Optional workflow to route this submission to. 'hitl' sends it through human review; 'non-hitl' sends it straight through the automated workflow.

Response

id
string
required

Newly-created pingid. Use this as the identifier for future requests.

message
string
required

Server message indicating the request was successful.

url
string
required

URL to the submission. Use this to view the submission in the UI.