/v1/submissionsSend one deal to one lender
Sends ONE deal to ONE lender. rowId is the DEAL's id, or a record on this workspace's Submissions page: from a deal the server finds that deal's submission for this lender or makes it, and reads the merchant off the deal's Merchant, so merchantKey is needed only when the deal has none. The lender is lenderId (a record on your Lenders board, required when rowId is a deal) or lenderTenantId (the receiving workspace). The lender's record decides how it goes: linked to a Specter workspace (put_lender-workspaces_rowId) it is a share; otherwise the package goes through the submission mailer with the deal's files named in documentIds attached, under the workspace's standard template with note added; with neither it is refused 422 lender_unreachable. It is the same send as the deal's prepare-send and is refused for the same reasons: a mailed lender needs its PDF minimum among documentIds (4 unless its record says otherwise), every file landed and readable, an address that has not opted out, and submission email switched on for the workspace. 409 when this lender already has it. For several lenders in one call reach for post_submissions_bulk; to see where the sends already stand, get_submissions.
Access class: workspace.
Send request
Use the documented inputs to call this endpoint directly.
Request body
application/jsonrequiredResponses
the action's answer
{
"data": {
"channel": "string",
"counterAmountMinor": 1,
"counterFactorRate": 1.5,
"counterTermMonths": 1,
"createdAt": "2026-01-01T00:00:00Z",
"dealRowId": "",
"decidedAt": "2026-01-01T00:00:00Z",
"declineCode": "string",
"direction": "string",
"id": "",
"lenderEmail": "string",
"lenderRowId": "",
"mayMove": [
"string"
],
"merchantKey": "string",
"offeredAmountMinor": 1,
"offeredFactorRate": 1.5,
"offeredPaymentAmountMinor": 1,
"offeredTermMonths": 1,
"preparedMessage": {
"body": "string",
"documentIds": [
"string"
],
"notes": "string",
"subject": "string"
},
"receivingTenantId": 1,
"record": {
"archived_at": "2026-01-01T00:00:00Z",
"assignees": {},
"cells": {},
"createdBy": "string",
"display": {},
"externalId": "",
"groupId": "",
"id": "",
"next_statuses": [
"string"
],
"position": 1,
"source": "string"
},
"responseReceivedAt": "2026-01-01T00:00:00Z",
"sentAs": "string",
"sharedByUserId": 1,
"sharingTenantId": 1,
"status": "string",
"statusChangedAt": "2026-01-01T00:00:00Z",
"statusChangedByTenantId": 1,
"statusReason": "string",
"submissionRowId": "",
"submittedAt": "2026-01-01T00:00:00Z",
"updatedAt": "2026-01-01T00:00:00Z",
"withdrawnAt": "2026-01-01T00:00:00Z"
}
}a refusal: {"error": "<what a person needs to read>"}. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.
{
"error": "string"
}