offer.create

Creates a new Offer

Requires the offersWrite permission.

Offer forms support a variety of field types. The values accepted for each field depend on the type of field that's being filled out:

  • Boolean - A boolean value.
  • Currency - An object in the format { currencyCode: "USD", value: 100000 } where currencyCode is a valid ISO 4217 currency code and value is an integer.
  • Date - A valid ISO Date string.
  • Number - An integer.
  • String - A string.
  • ValueSelect - A string that matches the value of one of the ValueSelect field's selectable options.
  • MultiValueSelect - An array of strings that exist in the MultiValueSelect field's selectable options.

Error codes:

CodeDescription
opening_in_useThe opening is already in use by another offer.
opening_state_invalidThe opening has already been closed or filled by a different application..
Body Params
uuid
required

The id of the offer process associated with the offer you're creating. This value is the id included in the response of the offerProcess.start API.

uuid
required

The id of the form associated with the offer. This value is the id included in the response of the offer.start API.

offerForm
object
required
Response

Language
Credentials
Basic
base64
:
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json