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.
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`.
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
{
"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
{
"errors": [
{
"field": "string",
"message": "string"
}
]
} View as Markdown · API reference overview
Spotted something wrong or out of date on this page? Tell us and we'll correct it.