Create Submission

curl --request POST \
  --url https://app.aiinsurance.io/api/v1/external/companies/{companyId}/submissions \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "submissionType": "newBusiness",
  "submissionName": "Acme Corp New Business"
}
'

import requests

url = "https://app.aiinsurance.io/api/v1/external/companies/{companyId}/submissions"

payload = {
    "submissionType": "newBusiness",
    "submissionName": "Acme Corp New Business"
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({submissionType: 'newBusiness', submissionName: 'Acme Corp New Business'})
};

fetch('https://app.aiinsurance.io/api/v1/external/companies/{companyId}/submissions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.aiinsurance.io/api/v1/external/companies/{companyId}/submissions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'submissionType' => 'newBusiness',
    'submissionName' => 'Acme Corp New Business'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.aiinsurance.io/api/v1/external/companies/{companyId}/submissions"

	payload := strings.NewReader("{\n  \"submissionType\": \"newBusiness\",\n  \"submissionName\": \"Acme Corp New Business\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.aiinsurance.io/api/v1/external/companies/{companyId}/submissions")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"submissionType\": \"newBusiness\",\n  \"submissionName\": \"Acme Corp New Business\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.aiinsurance.io/api/v1/external/companies/{companyId}/submissions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"submissionType\": \"newBusiness\",\n  \"submissionName\": \"Acme Corp New Business\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "550e8400-e29b-41d4-a716-446655440010"
}

Submissions

Create Submission

Creates a new Field Model V1 submission.

The request body is a flat JSON object where keys are field referenceIds defined in the company’s field configuration. Use the Configuration endpoint to discover available fields.

Required field: submissionType must be provided.

Lifecycle fields (submissionStatus, submissionNumber, submissionName, submissionPrimaryInsured, submissionBoundDate, submissionQuotes) are system-managed. submissionStatus defaults to inProgress if not provided.

Required permission: company.submission:create

POST

api

external

companies

{companyId}

submissions

Create Submission

curl --request POST \
  --url https://app.aiinsurance.io/api/v1/external/companies/{companyId}/submissions \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "submissionType": "newBusiness",
  "submissionName": "Acme Corp New Business"
}
'

import requests

url = "https://app.aiinsurance.io/api/v1/external/companies/{companyId}/submissions"

payload = {
    "submissionType": "newBusiness",
    "submissionName": "Acme Corp New Business"
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({submissionType: 'newBusiness', submissionName: 'Acme Corp New Business'})
};

fetch('https://app.aiinsurance.io/api/v1/external/companies/{companyId}/submissions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.aiinsurance.io/api/v1/external/companies/{companyId}/submissions",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'submissionType' => 'newBusiness',
    'submissionName' => 'Acme Corp New Business'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.aiinsurance.io/api/v1/external/companies/{companyId}/submissions"

	payload := strings.NewReader("{\n  \"submissionType\": \"newBusiness\",\n  \"submissionName\": \"Acme Corp New Business\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.aiinsurance.io/api/v1/external/companies/{companyId}/submissions")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"submissionType\": \"newBusiness\",\n  \"submissionName\": \"Acme Corp New Business\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.aiinsurance.io/api/v1/external/companies/{companyId}/submissions")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"submissionType\": \"newBusiness\",\n  \"submissionName\": \"Acme Corp New Business\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "550e8400-e29b-41d4-a716-446655440010"
}

Authorizations

Authorization

string

header

required

API key authentication. Include your API key in the Authorization header.

Path Parameters

companyId

string<uuid>

required

Company identifier

Body

application/json

Submission field data (keys are field referenceIds)

Response

Submission created

string<uuid>

required

Newly created submission ID

List Submissions Get Submission

⌘I

Getting Started

Exposures

Events

Event Financials

Policies

Submissions

Quotes

Rating

Custom Objects

Configuration Management

Basic Policies

Company Files

Document Generation

Submission Parsing

Address Tools

Reference

Create Submission

Authorizations

Path Parameters

Body

Response