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

NameInTypeRequiredDescription
orgId path string yes Organization ID

Request Body

Required. Content-Type: application/json · Schema: FundingApplication

FundingApplication fields:

FieldTypeRequiredDescription
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:

FieldTypeRequiredDescription
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:

FieldTypeRequiredDescription
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:

FieldTypeRequiredDescription
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:

FieldTypeRequiredDescription
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:

FieldTypeRequiredDescription
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:

FieldTypeRequiredDescription
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:

FieldTypeRequiredDescription
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:

FieldTypeRequiredDescription
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:

FieldTypeRequiredDescription
field string no
message string no

FundingApplication fields:

FieldTypeRequiredDescription
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:

FieldTypeRequiredDescription
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:

FieldTypeRequiredDescription
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:

FieldTypeRequiredDescription
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:

FieldTypeRequiredDescription
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:

FieldTypeRequiredDescription
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:

FieldTypeRequiredDescription
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:

FieldTypeRequiredDescription
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:

FieldTypeRequiredDescription
errors array<FundingApplicationFieldMappingIssue> no

FundingApplicationFieldMappingIssue fields:

FieldTypeRequiredDescription
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.