# Save a Funding Application Draft

`POST https://api.suger.cloud/org/{orgId}/fundingApplication/draft`

Save an AWS funding application as a draft for a person to review. The draft is not sent to AWS Partner Central: it is stored with status DRAFT and approval status Submitted, whatever approvalInfo the body carries, and SubmitFundingApplication is the call that sends it. Fields still missing or invalid do not block the save; the response lists them in `errors` (empty when the draft is ready to submit), so fill them and call this again with the draft's `id` to update the same draft. The body is a funding application: put the AWS benefit application in `info.awsBenefitApplication` (the `fundingApplication` object that PreviewFundingApplicationFieldMapping returns has that shape) and the CRM link in `salesforceOpportunityId` or `hubspotDealId`. `info.BenefitId` names the program and is required; an unknown program is rejected with 400 and nothing is saved. Updating an application that is not an unsent draft returns 409; an `id` that names no application returns 404.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `orgId` | path | string | yes | Organization ID |

## Request Body

Required.

Content-Type: `application/json` · Schema: `FundingApplication`

**`FundingApplication`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `approvalInfo` | ApprovalInfo | no |  |
| `creationTime` | string | no | CreationTime holds the value of the "creation_time" field. |
| `errorMessages` | array<string> | no | ErrorMessages holds the value of the "error_messages" field. |
| `externalId` | string | no | ExternalID holds the value of the "external_id" field. |
| `hubspotDealId` | string | no | HubspotDealID holds the value of the "hubspot_deal_id" field. |
| `id` | string | no | ID of the ent. |
| `info` | FundingApplicationInfo | no |  |
| `lastUpdateTime` | string | no | LastUpdateTime holds the value of the "last_update_time" field. |
| `organizationId` | string | no | OrganizationID holds the value of the "organization_id" field. |
| `partner` | FundingapplicationPartner | no |  |
| `salesforceFundingId` | string | no | SalesforceFundingID holds the value of the "salesforce_funding_id" field. |
| `salesforceOpportunityId` | string | no | SalesforceOpportunityID holds the value of the "salesforce_opportunity_id" field. |
| `status` | string | no | Status holds the value of the "status" field. |

**`ApprovalInfo`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `approvalStatus` | ApprovalStatus | no |  |
| `decisionDate` | string | no | DecisionDate is when the final approval/decline happened (nil when pending) Latest DecisionDate |
| `message` | string | no | Message is the reason or explanation provided when the approval status is set to Declined or Action Required. It always stores the latest message for the current status transition. Historical messages are stored in notification events. |
| `requestDate` | string | no | Latest RequestDate |

**`FundingApplicationInfo`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `awsBenefitAllocation` | BenefitAllocation | no |  |
| `awsBenefitAllocations` | array<BenefitAllocation> | no | AWSBenefitAllocations is every allocation AWS gave the application, primary first; awsBenefitAllocation holds the primary (see MergeAWSBenefitAllocation) for readers that expect one. AWS can give one application several: a legacy MDF combo request has a cash and a credit pool, and AWS re-creates some credit allocations. Rows synced before this field existed leave it empty. |
| `awsBenefitApplication` | BenefitApplication | no |  |
| `cosellAgent` | FundingApplicationCosellAgentInfo | no |  |

**`BenefitAllocation`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `ApplicableBenefitIds` | array<string> | no | The IDs of other benefits that this particular benefit allocation is applicable for. |
| `Arn` | string | no |  |
| `BenefitApplicationId` | string | no |  |
| `BenefitId` | string | no |  |
| `Catalog` | string | no |  |
| `CreatedAt` | string | no |  |
| `Description` | string | no |  |
| `ExpiresAt` | string | no |  |
| `FulfillmentDetail` | BenefitAllocationFulfillmentDetail | no |  |
| `FulfillmentTypes` | array<FulfillmentType> | no |  |
| `Id` | string | no |  |
| `Name` | string | no |  |
| `StartsAt` | string | no |  |
| `Status` | BenefitAllocationStatus | no |  |
| `StatusReason` | string | no |  |
| `UpdatedAt` | string | no |  |

**`BenefitApplication`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `Arn` | string | no |  |
| `AssociatedResources` | array<string> | no |  |
| `Attributes` | object | no |  |
| `BenefitApplicationDetails` | object | no |  |
| `BenefitId` | string | no |  |
| `Catalog` | string | no |  |
| `CreatedAt` | string | no |  |
| `Description` | string | no |  |
| `FileDetails` | array<FileDetail> | no |  |
| `FulfillmentTypes` | array<FulfillmentType> | no |  |
| `Id` | string | no |  |
| `Name` | string | no |  |
| `PartnerContacts` | array<AceContact> | no |  |
| `Programs` | array<string> | no |  |
| `Revision` | string | no |  |
| `Stage` | string | no |  |
| `Status` | BenefitApplicationStatus | no |  |
| `StatusReason` | string | no |  |
| `StatusReasonCodes` | array<string> | no |  |
| `UpdatedAt` | string | no |  |

**`FundingApplicationCosellAgentInfo`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `approvedBy` | string | no | ApprovedBy is the person who approved it; in AUTO, the person the run acted for. |
| `mode` | CosellAgentMode | no |  |
| `referralId` | string | no | ReferralID is the co-sell referral the application was filed for. |
| `runId` | string | no | RunID is the agent run that proposed it ("chat" for one made in the co-sell chat). |
| `skillId` | string | no | SkillID is the agent skill that proposed it. |

**`FileDetail`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `BusinessUseCase` | string | no | Project Plan/Checklist", "Innovation Plan", "Marketing Plan", " Proof of Cost", "Assess Analysis Report", "Well Architected Review Report", "Success Criteria Report", "Customer Sign Off Template", "Partner Sign Off Template", "Customer Satisfaction Survey (CSAT)", "Migration Capability Review", "Other" |
| `CreatedAt` | string | no |  |
| `FileName` | string | no | ^[a-zA-Z0-9._-]+$ |
| `FileStatus` | string | no | PENDING, SUCCEDED, FAILED |
| `FileType` | string | no | Valid mime type:application/msword, application/vnd.openxmlformats-officedocument.wordprocessingml.document, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, application/vnd.openxmlformats-officedocument.presentationml.presentation, application/pdf, image/png, image/jpeg, image/svg+xml, text/csv |
| `FileURI` | string | no |  |
| `UpdatedAt` | string | no |  |

**`AceContact`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `BusinessTitle` | string | no |  |
| `Email` | string | no |  |
| `FirstName` | string | no |  |
| `LastName` | string | no |  |
| `Phone` | string | no |  |

## Responses

### 200 — Success

Content-Type: `application/json` · Schema: `FundingApplicationDraftResponse`

**`FundingApplicationDraftResponse`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `errors` | array<FundingApplicationFieldMappingIssue> | no | Errors lists what AWS Partner Central would reject today, one entry per field; empty when the draft is ready to submit. |
| `fundingApplication` | FundingApplication | no |  |

**`FundingApplicationFieldMappingIssue`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `field` | string | no |  |
| `message` | string | no |  |

**`FundingApplication`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `approvalInfo` | ApprovalInfo | no |  |
| `creationTime` | string | no | CreationTime holds the value of the "creation_time" field. |
| `errorMessages` | array<string> | no | ErrorMessages holds the value of the "error_messages" field. |
| `externalId` | string | no | ExternalID holds the value of the "external_id" field. |
| `hubspotDealId` | string | no | HubspotDealID holds the value of the "hubspot_deal_id" field. |
| `id` | string | no | ID of the ent. |
| `info` | FundingApplicationInfo | no |  |
| `lastUpdateTime` | string | no | LastUpdateTime holds the value of the "last_update_time" field. |
| `organizationId` | string | no | OrganizationID holds the value of the "organization_id" field. |
| `partner` | FundingapplicationPartner | no |  |
| `salesforceFundingId` | string | no | SalesforceFundingID holds the value of the "salesforce_funding_id" field. |
| `salesforceOpportunityId` | string | no | SalesforceOpportunityID holds the value of the "salesforce_opportunity_id" field. |
| `status` | string | no | Status holds the value of the "status" field. |

**`ApprovalInfo`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `approvalStatus` | ApprovalStatus | no |  |
| `decisionDate` | string | no | DecisionDate is when the final approval/decline happened (nil when pending) Latest DecisionDate |
| `message` | string | no | Message is the reason or explanation provided when the approval status is set to Declined or Action Required. It always stores the latest message for the current status transition. Historical messages are stored in notification events. |
| `requestDate` | string | no | Latest RequestDate |

**`FundingApplicationInfo`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `awsBenefitAllocation` | BenefitAllocation | no |  |
| `awsBenefitAllocations` | array<BenefitAllocation> | no | AWSBenefitAllocations is every allocation AWS gave the application, primary first; awsBenefitAllocation holds the primary (see MergeAWSBenefitAllocation) for readers that expect one. AWS can give one application several: a legacy MDF combo request has a cash and a credit pool, and AWS re-creates some credit allocations. Rows synced before this field existed leave it empty. |
| `awsBenefitApplication` | BenefitApplication | no |  |
| `cosellAgent` | FundingApplicationCosellAgentInfo | no |  |

**`BenefitAllocation`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `ApplicableBenefitIds` | array<string> | no | The IDs of other benefits that this particular benefit allocation is applicable for. |
| `Arn` | string | no |  |
| `BenefitApplicationId` | string | no |  |
| `BenefitId` | string | no |  |
| `Catalog` | string | no |  |
| `CreatedAt` | string | no |  |
| `Description` | string | no |  |
| `ExpiresAt` | string | no |  |
| `FulfillmentDetail` | BenefitAllocationFulfillmentDetail | no |  |
| `FulfillmentTypes` | array<FulfillmentType> | no |  |
| `Id` | string | no |  |
| `Name` | string | no |  |
| `StartsAt` | string | no |  |
| `Status` | BenefitAllocationStatus | no |  |
| `StatusReason` | string | no |  |
| `UpdatedAt` | string | no |  |

**`BenefitApplication`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `Arn` | string | no |  |
| `AssociatedResources` | array<string> | no |  |
| `Attributes` | object | no |  |
| `BenefitApplicationDetails` | object | no |  |
| `BenefitId` | string | no |  |
| `Catalog` | string | no |  |
| `CreatedAt` | string | no |  |
| `Description` | string | no |  |
| `FileDetails` | array<FileDetail> | no |  |
| `FulfillmentTypes` | array<FulfillmentType> | no |  |
| `Id` | string | no |  |
| `Name` | string | no |  |
| `PartnerContacts` | array<AceContact> | no |  |
| `Programs` | array<string> | no |  |
| `Revision` | string | no |  |
| `Stage` | string | no |  |
| `Status` | BenefitApplicationStatus | no |  |
| `StatusReason` | string | no |  |
| `StatusReasonCodes` | array<string> | no |  |
| `UpdatedAt` | string | no |  |

**`FundingApplicationCosellAgentInfo`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `approvedBy` | string | no | ApprovedBy is the person who approved it; in AUTO, the person the run acted for. |
| `mode` | CosellAgentMode | no |  |
| `referralId` | string | no | ReferralID is the co-sell referral the application was filed for. |
| `runId` | string | no | RunID is the agent run that proposed it ("chat" for one made in the co-sell chat). |
| `skillId` | string | no | SkillID is the agent skill that proposed it. |

**`FileDetail`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `BusinessUseCase` | string | no | Project Plan/Checklist", "Innovation Plan", "Marketing Plan", " Proof of Cost", "Assess Analysis Report", "Well Architected Review Report", "Success Criteria Report", "Customer Sign Off Template", "Partner Sign Off Template", "Customer Satisfaction Survey (CSAT)", "Migration Capability Review", "Other" |
| `CreatedAt` | string | no |  |
| `FileName` | string | no | ^[a-zA-Z0-9._-]+$ |
| `FileStatus` | string | no | PENDING, SUCCEDED, FAILED |
| `FileType` | string | no | Valid mime type:application/msword, application/vnd.openxmlformats-officedocument.wordprocessingml.document, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, application/vnd.openxmlformats-officedocument.presentationml.presentation, application/pdf, image/png, image/jpeg, image/svg+xml, text/csv |
| `FileURI` | string | no |  |
| `UpdatedAt` | string | no |  |

**`AceContact`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `BusinessTitle` | string | no |  |
| `Email` | string | no |  |
| `FirstName` | string | no |  |
| `LastName` | string | no |  |
| `Phone` | string | no |  |

### 400 — The program is missing or unknown

Content-Type: `application/json` · Schema: `ValidateFundingApplicationResponse`

**`ValidateFundingApplicationResponse`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `errors` | array<FundingApplicationFieldMappingIssue> | no |  |

**`FundingApplicationFieldMappingIssue`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `field` | string | no |  |
| `message` | string | no |  |

### 404 — Not found

Content-Type: `application/json`

### 409 — Not an unsent draft

Content-Type: `application/json`

### 500 — Internal server error

Content-Type: `application/json`

## Example

_The request bodies are this operation's documented examples; the response and error bodies are generated from its schema. Substitute your own ids, and set `SUGER_TOKEN` to a bearer token from the [OAuth client-credentials exchange](https://doc.fours.com/settings/oauth-app/)._

### Request

Saves the request as a DRAFT for a person to review; nothing reaches AWS Partner Central until SubmitFundingApplication. `BenefitId` names the program (MPOPP Activate on the AWS catalog). The response lists the fields still missing in `errors`.

```bash
curl -X POST 'https://api.suger.cloud/org/{orgId}/fundingApplication/draft' \
  -H "Authorization: Bearer $SUGER_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
  "partner": "AWS",
  "salesforceOpportunityId": "006Hs00001AbCdEIAV",
  "info": {
    "awsBenefitApplication": {
      "Name": "Contoso Freight - MPOPP Activate",
      "BenefitId": "ben-fz5vn6p789ma76",
      "Catalog": "AWS",
      "AssociatedResources": [
        "arn:aws:partnercentral:us-east-1:aws:catalog/AWS/opportunity/O1234567"
      ],
      "PartnerContacts": [
        {
          "Email": "alliances@example.com",
          "FirstName": "Jordan",
          "LastName": "Lee",
          "BusinessTitle": "Alliance Manager"
        }
      ],
      "BenefitApplicationDetails": {
        "AwsAccountId": "123456789012",
        "OfferId": "offer-bpgicw3556ywx",
        "PlannedStartDate": "2026-11-01T00:00:00Z",
        "PlannedEndDate": "2026-12-31T00:00:00Z",
        "BusinessDescription": "Contoso Freight accepted a 12-month private offer for dispatch analytics on AWS.",
        "AnnualRunRate": {
          "Amount": "120000",
          "Currency": "USD"
        },
        "CreditRequest": {
          "NumberOfCodes": 1,
          "ValuePerCode": {
            "Amount": "5000",
            "Currency": "USD"
          }
        }
      }
    }
  }
}'
```

### Response — 200

```json
{
  "errors": [
    {
      "field": "string",
      "message": "string"
    }
  ],
  "fundingApplication": {
    "approvalInfo": {
      "approvalStatus": "Submitted",
      "decisionDate": "2026-01-31T12:00:00Z",
      "message": "string",
      "requestDate": "2026-01-31T12:00:00Z"
    },
    "creationTime": "2026-01-31T12:00:00Z",
    "errorMessages": [
      "string"
    ],
    "externalId": "01H0000000000000000000",
    "hubspotDealId": "01H0000000000000000000",
    "id": "01H0000000000000000000",
    "info": {
      "awsBenefitAllocation": {
        "ApplicableBenefitIds": [
          "01H0000000000000000000"
        ],
        "Arn": "string",
        "BenefitApplicationId": "01H0000000000000000000",
        "BenefitId": "01H0000000000000000000",
        "Catalog": "string",
        "CreatedAt": "string",
        "Description": "string",
        "ExpiresAt": "string",
        "FulfillmentDetail": {},
        "FulfillmentTypes": [
          "CREDITS"
        ],
        "Id": "01H0000000000000000000",
        "Name": "Acme Corp"
      },
      "awsBenefitAllocations": [
        {
          "ApplicableBenefitIds": [],
          "Arn": "string",
          "BenefitApplicationId": "01H0000000000000000000",
          "BenefitId": "01H0000000000000000000",
          "Catalog": "string",
          "CreatedAt": "string",
          "Description": "string",
          "ExpiresAt": "string",
          "FulfillmentDetail": {},
          "FulfillmentTypes": [],
          "Id": "01H0000000000000000000",
          "Name": "Acme Corp"
        }
      ],
      "awsBenefitApplication": {
        "Arn": "string",
        "AssociatedResources": [
          "string"
        ],
        "Attributes": {},
        "BenefitId": "01H0000000000000000000",
        "Catalog": "string",
        "CreatedAt": "string",
        "Description": "string",
        "FileDetails": [
          {}
        ],
        "FulfillmentTypes": [
          "CREDITS"
        ],
        "Id": "01H0000000000000000000",
        "Name": "Acme Corp"
      },
      "cosellAgent": {
        "approvedBy": "string",
        "mode": "REVIEW",
        "referralId": "01H0000000000000000000",
        "runId": "01H0000000000000000000",
        "skillId": "01H0000000000000000000"
      }
    },
    "lastUpdateTime": "2026-01-31T12:00:00Z",
    "organizationId": "01H0000000000000000000",
    "partner": "AWS",
    "salesforceFundingId": "01H0000000000000000000",
    "salesforceOpportunityId": "01H0000000000000000000"
  }
}
```

### Error — 400

```json
{
  "errors": [
    {
      "field": "string",
      "message": "string"
    }
  ]
}
```

---

API reference: https://doc.fours.com/api/
