Save or submit a contract

curl -X POST "https://api.spyne.ai/credit/v6/contracting/create-contract-v2" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "isDraft": false,
    "contractId": "CONTRACT_ID",
    "contractDetails": {
      "enterpriseId": "ENTERPRISE_ID",
      "currency": "USD",
      "dealType": "New Deal",
      "customerType": "Individual Dealer",
      "managerName": ""
    },
    "customerDetails": {
      "legalName": "Example Motors LLC",
      "brandName": "Example Motors",
      "region": "AMER",
      "streetAddress": "100 Example Street",
      "country": "United States",
      "pincode": "00000",
      "city": "Example City",
      "state": "Example State"
    },
    "pricing": {
      "conversationalAi": { "type": "<type>", "allowedProducts": {}, "items": {} }
    },
    "rooftops": [
      {
        "rooftopName": "Example Motors",
        "subType": "Franchise Dealer",
        "region": "AMER",
        "streetAddress": "100 Example Street",
        "country": "United States",
        "pincode": "00000",
        "city": "Example City",
        "state": "Example State",
        "bundle": "bundle-1",
        "productsLines": [
          {
            "productLineName": "conversationalAi",
            "plan": "",
            "oneTimePurchases": [],
            "products": [
              { "product": "salesInbound", "units": "100", "unitType": "vinsPerMonth", "cost": 0 },
              { "product": "serviceInbound", "units": "100", "unitType": "roPerMonth", "cost": 0 }
            ]
          }
        ]
      }
    ],
    "signatoryDetails": {
      "name": "Jane Doe",
      "email": "[email protected]",
      "designation": "General Manager",
      "contactNumber": { "isdCode": "+1", "number": "5550100000" },
      "clientPOCs": []
    },
    "billingDetails": {
      "billingFrequency": 12,
      "financePOCName": "John Doe",
      "financePOCEmail": "[email protected]",
      "financePOCNumber": { "isdCode": "+1", "number": "5550100000" }
    },
    "terms": {
      "t&cTemplatePath": "contracts/default-terms-and-conditions-template.pdf",
      "exception": false,
      "contractTerm": 12,
      "lockInPeriod": 12,
      "terminationDays": 30,
      "noticePeriodForAutoRenewal": 30,
      "editT&C": false
    },
    "line_items": {
      "type": "bundle",
      "value": {
        "bundle-1": {
          "existingInventoryPerRooftop": 0,
          "rooftopsCount": 1,
          "studioAi": { "studio": [], "addOns": [] },
          "conversationalAi": {
            "salesAgent": [
              { "type": "Inbound", "frequency": "Monthly", "basePrice": 0, "discountAmount": 0, "discountPercent": 0, "finalPrice": 0, "units": 100 }
            ],
            "serviceAgent": [
              { "type": "Inbound", "frequency": "Monthly", "basePrice": 0, "discountAmount": 0, "discountPercent": 0, "finalPrice": 0, "units": 100 }
            ],
            "receptionAgent": [],
            "acquisitionAgent": [],
            "addOns": []
          }
        }
      }
    },
    "summary": {
      "totalOneTimeFee": 0,
      "totalMonthlyRecurringFee": 0,
      "totalAnnuallyRecurringFee": 0
    }
  }'

import json
import requests

# contract.json holds the same body as the cURL example
with open("contract.json") as f:
    payload = json.load(f)

res = requests.post(
    "https://api.spyne.ai/credit/v6/contracting/create-contract-v2",
    json=payload,
    headers={"Authorization": "Bearer YOUR_TOKEN"},
)
print(res.status_code, res.json())
contract_id = res.json()["data"]["contractId"]

import { readFile } from "node:fs/promises";

// contract.json holds the same body as the cURL example
const payload = JSON.parse(await readFile("contract.json", "utf8"));

const res = await fetch("https://api.spyne.ai/credit/v6/contracting/create-contract-v2", {
  method: "POST",
  headers: { Authorization: "Bearer YOUR_TOKEN", "Content-Type": "application/json" },
  body: JSON.stringify(payload),
});
const body = await res.json();
console.log(res.status, body);
const contractId = body.data.contractId;

{
  "message": "Contract created successfully",
  "error": false,
  "code": "",
  "details": null,
  "data": {
    "success": true,
    "message": "Contract initiated successfully. Ready to send for signature.",
    "contractId": "CONTRACT_ID",
    "enterpriseId": "ENTERPRISE_ID",
    "contractStage": "Contract-Initiated",
    "note": "Child documents will be created after contract is fully signed"
  }
}

{
  "message": "Contract created successfully",
  "error": false,
  "code": "",
  "details": null,
  "data": {
    "success": true,
    "isDraft": true,
    "message": "Draft contract saved successfully",
    "contractId": "CONTRACT_ID",
    "enterpriseId": "ENTERPRISE_ID",
    "contractStage": "Draft"
  }
}

{
  "message": "Signatory email is required",
  "error": true,
  "code": "",
  "details": null,
  "data": {}
}

{
  "message": "Rooftop #1 \"Example Motors\":\n  - bundle is required\n  - Conversational AI → salesInbound: Unit type is required",
  "error": true,
  "code": "",
  "details": null,
  "data": {}
}

{
  "message": "Enterprise not found",
  "error": true,
  "code": "",
  "details": null,
  "data": { "enterpriseId": "ENTERPRISE_ID" }
}

{ "message": "Invalid Token", "error": true, "code": "ERROR_AUTH_401", "details": null, "data": null }

{
  "message": "Contract not found with ID: CONTRACT_ID",
  "error": true,
  "code": "",
  "details": null,
  "data": {}
}