Create Private Offer

post

https://aws.offers.tackle.io/api/private-offers

Creates a draft private offer. Set create_in_marketplace: true in the
request body to also push the offer to AWS Marketplace in the same
call; otherwise the offer is saved as a Tackle draft that can be
pushed later via POST /private-offers/{id}/marketplace-create.

Set dry_run: true to validate the payload without persisting the
offer; a successful dry run returns 200 OK instead of 201 Created.

Required RBAC permission: offers:CreateDraftOffer

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Request body for creating or updating a private offer. The wrapper
controls how the request is processed; the private_offer field
carries the offer payload.

For AWS, the private_offer.offer_type field discriminates the body
shape:

direct -- ISV-to-buyer offer.
partner_resale -- AWS resale (Resale Authorization + CPPO) offer.

See the PrivateOffer schema for the full set of fields supported by
the private_offer body. Conditional validation rules (e.g.
service_start_at is required when billing_term is future_dated)
are enforced server-side.

create_in_marketplace

boolean

required

When false, creates a draft offer in Tackle only. When true,
additional marketplace-specific validation is applied and the
offer is sent to the marketplace after being saved in Tackle.

send_buyer_instructions

boolean

required

Whether the buyer should receive purchase-instructions email
immediately after the offer is created. Must be true for AWS
offers that are pushed to marketplace.

dry_run

boolean

required

When true, validates the payload without saving it or sending
it to the marketplace. A successful dry run returns 200; a
successful real run returns 201.

vendorid

string | null

Vendor ID to use for the offer. Inferred from the bearer token
when omitted.

private_offer

object

required

Represents a private offer for any cloud marketplace and product type.
Field shapes are backward-compatible with the private_offer_metadata
object documented in the
Tackle webhook reference.

Responses

Language

Credentials

Bearer

JWT

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Dry-run validation succeeded.

201Private offer created.

400Request was malformed or failed validation.

401Missing or invalid Tackle JWT.

403Caller is authenticated but not authorized for this resource.

500An unexpected server error occurred.