# contractorOps.agreements.contractorDraft

Prefill for filing a signed agreement or NDA that has no contractor (envelopeId, or intakeItemId of the filed upload): the other party's name, email addresses, role and the job role and level it matches, rate, start and end dates and where they live, as the document states them with the words each came from, plus existing contractors it may be (any address Oatmilk knows for them, then the same name, then a close name) with which of the document's addresses each uses and whether the document is newer than their terms. Pass the name and email being added (name, email) to look those up too. Nothing is saved.

`GET | POST /api/v1/accounting/contractorOps.agreements.contractorDraft`

Permissions: `accounting:read` · Roles: admin, finance

MCP tool: `accounting_contractor_ops_agreements_contractor_draft`

## Fields

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `envelopeId` | string (ID) |  | The ID of a document sent for signature, from signing.envelopes.list. |
| `intakeItemId` | string (ID) |  | The ID of the related record. |
| `name` | string |  | A display name. at most 300 characters. |
| `email` | string (email) |  | An email address. at most 320 characters. |

## Example request

```bash
curl -G https://app.getoatmilk.com/api/v1/accounting/contractorOps.agreements.contractorDraft \
  -H "Authorization: Bearer $OATMILK_API_KEY" \
  --data-urlencode 'envelopeId=9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d'
```

Reference page: https://app.getoatmilk.com/docs/api/contractorOps.agreements.contractorDraft