# signing.envelopes.importExecuted

Record an agreement signed outside Oatmilk: fileId from signing.files.confirm (or googleDocUrl), title, executedOn, parties, optional endsOn and linked record (for example subjectType contractor). The original is kept unchanged with its hash and the envelope is marked completed as the agreement on file.

`POST /api/v1/accounting/signing.envelopes.importExecuted`

Permissions: `accounting:read`, `accounting:write` · Roles: admin, finance · Idempotency key required

MCP tool: `accounting_signing_envelopes_import_executed`

## Fields

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `title` | string | Yes | A short title. 1–200 characters. |
| `fileId` | string (ID) |  | The ID of the related record. |
| `googleDocUrl` | string (uri) |  | at most 2000 characters. |
| `executedOn` | string (date) | Yes | A date, as YYYY-MM-DD. |
| `endsOn` | string (date) |  | A date, as YYYY-MM-DD. |
| `parties` | array of objects | Yes | 1–10 items. |
| `parties[].name` | string | Yes | A display name. 1–200 characters. |
| `parties[].email` | string (email) or null |  | An email address. |
| `parties[].title` | string or null |  | A short title. |
| `parties[].company` | string or null |  |  |
| `subjectType` | enum |  | The kind of record this is about, such as entry, invoice or mail. One of: `contractor`, `party`, `invoice`. |
| `subjectId` | string |  | The ID of the record this is about. 1–200 characters. |
| `notes` | string |  | Notes kept with the record. at most 4000 characters. |
| `idempotencyKey` | string | Yes | Any unique text you generate once per intended change, so a retried request only happens once. Send it as the Idempotency-Key header instead if you prefer; if you send both they must match. 8–200 characters. |

## Example request

```bash
curl https://app.getoatmilk.com/api/v1/accounting/signing.envelopes.importExecuted \
  -H "Authorization: Bearer $OATMILK_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "title": "Synthetic services agreement",
  "executedOn": "2026-09-01",
  "parties": [
    {
      "name": "Synthetic Ventures Inc."
    }
  ],
  "fileId": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d"
}'
```

Reference page: https://app.getoatmilk.com/docs/api/signing.envelopes.importExecuted