v29

latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-06-042661,1122.5 MB

billing

Create insertion order through SSIO.

Create insertion order through SSIO for ad_account_id.

The token's user_account must either be the owner of the specified ad account, or have one of the necessary roles granted via Business Access: Admin, Finance, Campaign.

post/ad_accounts/{ad_account_id}/ssio/insertion_orders

Path parameters

ad_account_idstring required

Unique identifier of an ad account.

Request body

accepted_terms_idstring required

The SFDC id for the terms

accepted_terms_timeinteger

The UTC timestamp (to the nearest sec) of when terms were accepted

agency_linkstring

URL link for agency

billing_contact_emailstring required

The billing contact email

billing_contact_firstnamestring required

The billing contact first name

billing_contact_lastnamestring required

The billing contact last name

billto_billing_address_idstring required

The bill-to billing address id

billto_business_address_idstring required

The bill-to business address id

billto_company_idstring required

The bill-to company id

budget_amountnumber double

If Budget order line, the budget amount.

currency_info'UNK' | 'USD' | 'GBP' | 'CAD' | 'EUR' | 'AUD' | 'NZD' | 'SEK' | 'ILS' | 'CHF' | 'HKD' | 'JPY' | 'SGD' | 'KRW' | 'NOK' | 'DKK' | 'PLN' | 'RON' | 'HUF' | 'CZK' | 'BRL' | 'MXN' | 'ARS' | 'CLP' | 'COP' | 'INR' | 'TRY' required

Currency Codes from ISO 4217

end_datestring

End date of time period. Format: YYYY-MM-DD

estimated_monthly_spendnumber double

If Ongoing (perpetual) order line, the estimated monthly spend

media_contact_emailstring required

The media contact email

media_contact_firstnamestring required

The media contact first name

media_contact_lastnamestring required

The media contact last name

order_line_type'BUDGET' | 'PERPETUALS' required

The type of an SSIO order line.

order_namestring required

The order name

pmp_idstring required

The pmp id

po_numberstring required

The po number

start_datestring required

Starting date of time period. Format: YYYY-MM-DD

user_emailstring

The email of user submitting the insertion order

Response

The request has succeeded.

pin_order_idstring

Salesforce order id

Example response

{
  "pin_order_id": "9991h00000046NyCAI"
}