Commerce

`createOffer`

Create Offer

Create a Space Offer as a PRIVATE draft (never auto-publishes).

write

Arguments

spaceIdstringrequiredThe Space (team) ID that owns the offer.
namestringrequiredOffer name, e.g. 'ENOK Library Card'.
descriptionstringoptionalShort offer description.
kindstringrequiredPricing kind: one_time, subscription, or installment.
amountCentsintegerrequiredPrice in cents, e.g. 1000 = $10.00.
currencystringoptionalISO 4217 currency, default usd.
intervalstringoptionalRequired for subscription: day, week, month, or year.
intervalCountintegeroptionalIntervals between charges. Unit-specific maximum is 3 years.
installmentCountintegeroptionalNo description is declared in the tool schema.
trialDaysintegeroptionalNo description is declared in the tool schema.

Returns

The result states the remaining steps to a shareable checkout link: bindSpacePaymentAccount first if needed, then setOfferVisibility public with confirm:true, which returns the link.

Declared limits

amountCents: greater than 0
amountCents: maximum 9007199254740991
intervalCount: greater than 0
intervalCount: maximum 1095
installmentCount: greater than 0
installmentCount: maximum 9007199254740991
trialDays: minimum 0
trialDays: maximum 9007199254740991

Ask for it

The Cloud routes these requests to this verb.

create the $10/year Library Card
add a membership offer
set up Space checkout
concierge an offer

Pair it with

The verbs that finish the job.