Skip to main content
POST
Upload contract

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

multipart/form-data
file
file
required

The contract file to upload. Only PDF files are accepted.

executedDate
string

ISO 8601 date indicating when the contract was executed.

accountId
string

ID of the customer trust account to associate with this contract.

externalId
string

Stable source-system identifier used to reject duplicate contract uploads; repeats return 409. Use the upstream document or record ID when available, such as the Microsoft Graph DriveItem ID for SharePoint or the Ironclad record ID for Ironclad. If there is no source system, generate and store a durable idempotency key. Maximum 256 characters.

Response

201 - application/json

Contract created

id
string
required

Unique identifier for the contract.

externalId
string | null
required

Stable source-system identifier for the contract, if any.

name
string
required

Name of the contract.

customerTrustAccountId
string | null
required

The ID of the customer trust account this contract is linked to, if any.

executedDate
string<date-time> | null
required

Date this contract was executed.

creationDate
string<date-time>
required

Date this contract was created in Vanta.