Create Pin
POST {{baseUrl}}/pins?ad_account_id=15266090296
Create a Pin on a board or board section owned by the operation user_account
.
Note: If the current operation user_account
(defined by the access token) has access to another user's Ad Accounts via Pinterest Business Access, you can modify your request to make use of the current operationuseraccount's permissions to those Ad Accounts by including the adaccountid in the path parameters for the request (e.g. .../?adaccountid=12345&...).
- This function is intended solely for publishing new content created by the user. If you are interested in saving content created by others to your Pinterest boards, sometimes called 'curated content', please use our Save button instead. For more tips on creating fresh content for Pinterest, review our Content App Solutions Guide.
Learn more about video Pin creation.
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
ad_account_id | number | Unique identifier of an ad account. |
Request Body
{"id"=>"6212908", "created_at"=>"<dateTime>", "link"=>"<string>", "title"=>"<string>", "description"=>"<string>", "dominant_color"=>"<string>", "alt_text"=>"<string>", "board_id"=>"718", "board_section_id"=>"5", "board_owner"=>{"username"=>"<string>"}, "media"=>{"media_type"=>"<string>"}, "media_source"=>{"source_type"=>"image_base64", "content_type"=>"image/jpeg", "data"=>"WFwV", "is_standard"=>true}, "parent_pin_id"=>"4249932898", "note"=>"<string>"}
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Content-Type | string | ||
Accept | string |
RESPONSES
status: Created
{"id":"1594502317","created_at":"\u003cdateTime\u003e","link":"\u003cstring\u003e","title":"\u003cstring\u003e","description":"\u003cstring\u003e","dominant_color":"\u003cstring\u003e","alt_text":"\u003cstring\u003e","creative_type":"SHOWCASE","board_id":"25","board_section_id":"96527540644","board_owner":{"username":"\u003cstring\u003e"},"is_owner":"\u003cboolean\u003e","media":{"media_type":"\u003cstring\u003e"},"media_source":{"source_type":"image_base64","content_type":"image/png","data":"6iB1vO3","is_standard":true},"parent_pin_id":"7082463","is_standard":"\u003cboolean\u003e","has_been_promoted":"\u003cboolean\u003e","note":"\u003cstring\u003e","pin_metrics":{}}