ad_accounts14

ad_groups13

ads10

advanced_auction2

audience_insights2

audience_sharing7

audiences4

billing11

boards11

bulk3

business_access_assets12

business_access_invite6

business_access_relationships9

campaigns8

catalog_feeds8

catalog_items3

catalog_product_groups10

catalog_reports3

catalog_supplemental7

catalogs3

conversion_deletion_requests4

conversion_eqs1

conversion_events1

conversion_tags5

conversions4

customer_list_uploads3

customer_lists4

customer_segment3

integrations7

keywords5

labels5

lead_ads4

lead_forms5

leads_export2

media3

msot_events1

notification1

oauth3

order_lines2

pins8

product_group_promotions5

product_tags3

promotions5

resources6

schedules3

search3

targeting_template3

terms2

terms_of_service1

trends4

user_account14

billing

Create insertion order through SSIO.

Changed on Jun 4, 2026

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

Request

Base URL
https://api.pinterest.com/v5
Auth
OAuth 2
Authorization codehttps://www.pinterest.com/oauth/
Token URLhttps://api.pinterest.com/v5/oauth/token
Scopesads:write
TypeScript
https://skmtc.dev/pinterest/apis/pinterest-rest-api/docs/ad_accounts/:ad_account_id/ssio/insertion_orders/post.ts
A function with typed inputs. Its response is checked against the schema.

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"
}

Changes

Jun 4, 2026v5b698c180678a Revision changes
- breaking
  added the new required request property
- breaking
  added the new required request property
- breaking
  added the new required request property
- breaking
  added the new required request property
- breaking
  added the new required request property
- breaking
  added the new required request property
- breaking
  added the new required request property
- breaking
  added the new required request property
- breaking
  added the new required request property
- breaking
  added the new required request property
- breaking
  added the new required request property
- breaking
  added the new required request property
- breaking
  added the new required request property
- breaking
  added the new required request property
- breaking
  added the new required request property
- breaking
  added the new required request property
- warning
  removed subschema #2 from the request body allOf list
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  the response optional property became read-only for the status
- info
  added the success response with the status
Aug 14, 2024v589c27ed39cfd Revision changes
- info
  added the new INR enum value to the request property /
- info
  added the new TRY enum value to the request property /

Operation history (5 revisions)