Skip to main content
POST
Save and submit deal for approval

Authorizations

nonce
string
query
required

WordPress AJAX nonce — either sagescreen_frontend_nonce or sagescreen_sales_calc depending on the endpoint (see each endpoint description). Sent as a form field in the POST body.

Body

application/x-www-form-urlencoded

All deal form fields. Accepts both snake_case and camelCase keys (e.g. customer_name or customerName). Only nonce and action are strictly required; all other fields are optional on save.

nonce
string
required
Example:

"abc123def456"

action
enum<string>
required
Available options:
sagescreen_save_deal,
sagescreen_create_quote
dealId
integer

Existing deal post ID (omit for new deal)

Example:

1042

customerName
string
Example:

"Greenville City Council"

councilId
integer

Linked council post ID (for existing customers)

Example:

312

contactFirstName
string
Example:

"Bob"

contactLastName
string
Example:

"Johnson"

contactTitle
string
Example:

"IT Director"

contactEmail
string<email>
Example:

"bob@greenville.gov"

contactPhone
string
Example:

"+1-555-123-4567"

customerUrl
string<uri>
Example:

"https://greenville.gov"

customerIndustry
string
Example:

"Government"

companySize
string
Example:

"51-200"

companyRevenue
string
Example:

"$1M-$10M"

customerAddress
string
Example:

"100 Main Street"

customerAddress2
string
Example:

"Suite 200"

customerCity
string
Example:

"Greenville"

customerState
string
Example:

"SC"

customerZip
string
Example:

"29601"

customerCountry
string
Example:

"US"

numSages
integer
Example:

5

creditInputMode
string
Example:

"direct"

numCredits
integer
Example:

500

screensPerRole
integer
Example:

100

extraCredits
integer
Example:

0

creditsFloor
integer
Example:

100

creditsCeiling
integer
Example:

1000

tierLite
integer

Percentage (0-100)

Example:

20

tierCore
integer
Example:

60

tierAdvanced
integer
Example:

20

onboardingType
enum<string>

Onboarding tier selection

Available options:
self_serve,
white_glove
whiteGlovePrice
number<float>
Example:

5000

addonCustomBranding
boolean
Example:

true

addonCustomUrl
boolean
Example:

false

addonPrioritySupport
boolean
Example:

true

compliance
string

JSON-encoded array of compliance tags

Example:

"[\"hipaa\",\"soc2\"]"

integrations
string

JSON-encoded array of integration tags

Example:

"[\"salesforce\",\"workday\"]"

pricePerCredit
number<float>
Example:

2.5

pricePerSage
number<float>
Example:

125

growthRate
number<float>

Annual growth percentage

Example:

15

priceIncreaseRate
number<float>

Annual price increase percentage

Example:

3

discountMode
enum<string>

How the discount is expressed

Available options:
percent,
dollar,
discountPercent
number<float>
Example:

10

discountDollar
number<float>
Example:

0

hasReferral
boolean
Example:

false

expenseMonthly
number<float>
Example:

0

expenseAnnual
number<float>
Example:

0

expenseOnetime
number<float>
Example:

0

customerNotes
string
Example:

"Includes complimentary onboarding session."

quoteExpirationDays
integer
Example:

5

Response

Deal submitted for approval

success
boolean
data
object