Proposals
POST Create proposal
Create a new proposal envelope in draft state.
Endpoint
POST https://api.aiconnectos.com/v1/proposalsCreates an envelope in draft status. The author can then edit blocks in the dashboard or via the editor API before sending.
Request body
| Field | Type | Required | Notes |
|---|---|---|---|
title | string | yes | Internal title shown to author and recipient. |
contactId | uuid | yes | Primary recipient. Must exist in the org's contacts. |
totalAmount | string | no | Decimal string ("5000.00"). Omit for envelopes without pricing. |
currency | string | no | ISO 4217. Defaults to the org's primary currency. |
type | enum | no | "document" (default) or "template". |
expiresAt | iso8601 | no | Recipient can't sign after this time. |
externalId | string | no | Your system's id for idempotency. |
Response
{
"id": "env_…",
"secondaryId": "P-1042",
"status": "draft",
"url": "https://app.aiconnectos.com/proposals/P-1042/edit",
"createdAt": "2026-05-25T20:14:00Z"
}Example
curl -X POST https://api.aiconnectos.com/v1/proposals \
-H "Authorization: Bearer $STRIDE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"title": "Acme Corp - Q2 Engagement",
"contactId": "ctc_8f3e…",
"totalAmount": "5000.00",
"currency": "USD"
}'